@uipath/project-packager 1.202.0 → 1.203.0-preview.160

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

@@ -32,18 +32,25 @@ export declare const en: {
             readonly info: {
                 readonly alreadyProvided: "Governance policy file already provided, skipping download.";
                 readonly saved: "Governance policy saved to {path}";
-                readonly downloading: "Downloading governance policy from {url}";
-                readonly noPolicyFound: "No governance policy found for this configuration.";
-                readonly responseNotJson: "Policy response is not JSON, treating as no policy.";
+                readonly resolving: "Asking AutomationOps for the {product} policy, license type {licenseType}.";
+                readonly ungoverned: "AutomationOps publishes no policy for this tenant. Analyzing with the rules shipped with the WorkflowCompiler.";
+                readonly suppliedFileHonoured: "AutomationOps publishes no policy for this tenant, so the supplied governance file is used: {path}";
+                readonly suppliedFileUnchecked: "Using the supplied governance file, but the tenant's own policy could not be checked: {path}";
+                readonly noTenantToAsk: "No signed-in tenant to ask about governance. Using the supplied governance file: {path}";
                 readonly licenseStatus: "AcquireLicense returned {status}, using {fallback}.";
                 readonly licenseResponse: "AcquireLicense: isLicensed={isLicensed}, robotType={robotType}";
                 readonly licenseFailed: "AcquireLicense failed: {error}. Using {fallback}.";
             };
             readonly errors: {
-                readonly connectionIncomplete: "Connection info incomplete, falling back to Default governance.";
-                readonly failedToGetPolicy: "Failed to download governance policy: {content}";
-                readonly failedToSave: "Failed to save governance policy: {error}. Falling back to Default governance.";
-                readonly failedToDownload: "Failed to download governance policy: {error}. Falling back to Default governance.";
+                readonly connectionIncomplete: "Connection info is incomplete, so the tenant could not be asked about governance.";
+                readonly unknownOutcome: "Could not tell whether this tenant is governed ({reason}): {detail} Asked {url}.";
+                readonly retryAfter: "The policy service asked for {seconds} seconds before another try.";
+                readonly tenantPolicyWins: "The AutomationOps policy published for {product} applies to this tenant, so the governance file at {path} cannot replace it.";
+                readonly failedToSave: "Failed to save governance policy: {error}";
+                readonly fallingBackToDefault: "{reason} Analyzing with the rules shipped with the WorkflowCompiler.";
+            };
+            readonly instructions: {
+                readonly tenantPolicyWins: "Drop --governance-file-path so the tenant's policy is used, or ask an administrator to change the policy published in AutomationOps.";
             };
         };
         readonly signing: {

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
 import "./i18n/index.js";
+export { type PolicyAudit, type PolicyResolution, type PolicySubject, resolvePolicyAsync, type UnknownReason, } from "@uipath/aops-policy-sdk/resolver";
 export type { IContextStorage, ITelemetryProvider, ITelemetryService, TelemetryContext, TelemetryProperties, } from "@uipath/common";
 export { BrowserContextStorage, ConsoleTelemetryProvider, TelemetryService, } from "@uipath/common";
 export type { PackagerConfig } from "./models/packager-config.js";
@@ -15,10 +16,10 @@ export { ProjectPublishOptions, PublishDestinationKind, } from "./publish/models
 export type { IProjectPublisher } from "./publish/services/project-publisher.js";
 export { ProjectPublisher } from "./publish/services/project-publisher.js";
 export type { IGovernancePolicyService } from "./services/governance-policy-service.js";
-export { GovernancePolicyService } from "./services/governance-policy-service.js";
+export { GovernancePolicyError, GovernancePolicyService, } from "./services/governance-policy-service.js";
 export { resolveProducedNupkgsAsync } from "./services/nupkg-resolver.js";
-export type { IPackService } from "./services/pack-service.js";
-export { PackService } from "./services/pack-service.js";
+export type { IPackService, PackageIdTooLongError, } from "./services/pack-service.js";
+export { isPackageIdTooLongError, PACKAGE_ID_TOO_LONG, PackService, } from "./services/pack-service.js";
 export type { IPackageSignService } from "./services/package-sign-service.js";
 export { signNupkgsAsync } from "./services/package-signer.js";
 export type { IPackagerParametersValidator } from "./services/packager-parameters-validator.js";

package/dist/src/node.d.ts

@@ -28,8 +28,8 @@ export { DotnetDiscoveryService } from "./services/dotnet-discovery-service.js";
 export type { IGovernancePolicyService } from "./services/governance-policy-service.js";
 export { GovernancePolicyService } from "./services/governance-policy-service.js";
 export { resolveProducedNupkgsAsync } from "./services/nupkg-resolver.js";
-export type { IPackService } from "./services/pack-service.js";
-export { PackService } from "./services/pack-service.js";
+export type { IPackService, PackageIdTooLongError, } from "./services/pack-service.js";
+export { isPackageIdTooLongError, PACKAGE_ID_TOO_LONG, PackService, } from "./services/pack-service.js";
 export type { IPackageSignService } from "./services/package-sign-service.js";
 export { NodePackageSignService } from "./services/package-sign-service.js";
 export { signNupkgsAsync } from "./services/package-signer.js";

package/dist/src/services/governance-policy-service.d.ts

@@ -1,7 +1,41 @@
 import { type ConnectionInfo, type IFileSystem, type ITemporaryStorageService } from "@uipath/solutionpackager-tool-core";
 import { type ValidateOptions } from "../models/packager-parameters.js";
+/**
+ * What the caller is about to do with the analysis.
+ *
+ * `analyze` reports on a project and produces nothing shippable, so a
+ * developer testing a candidate policy file locally is always legitimate.
+ * `pack` produces an artefact that leaves the machine, so a supplied policy
+ * file is refused there in exactly one case: the tenant was asked and a
+ * published policy came back. Adding a flag to your own pipeline must not lift
+ * an organisation's policy.
+ *
+ * Every other answer keeps the file — nobody publishes one, the question went
+ * unanswered, or there was no tenant to ask. Not knowing is not grounds to
+ * withhold the only rules available; that would leave the pack less checked,
+ * not more.
+ */
+export type GovernanceUsage = "analyze" | "pack";
 export interface IGovernancePolicyService {
-    resolveGovernancePolicyAsync(validateOptions: ValidateOptions, connectionInfo?: ConnectionInfo, cancellationToken?: AbortSignal): Promise<void>;
+    resolveGovernancePolicyAsync(validateOptions: ValidateOptions, connectionInfo?: ConnectionInfo, cancellationToken?: AbortSignal, usage?: GovernanceUsage): Promise<void>;
+}
+/**
+ * The tenant publishes a policy that a supplied governance file cannot replace.
+ *
+ * The only hard failure this service produces. Nothing else about governance
+ * stops a command: an unanswerable question warns and carries on. This case is
+ * different because the question *was* answered — the organisation governs
+ * this tenant — so letting a flag on one developer's pipeline override it
+ * would be the escalation, not an exception to it.
+ *
+ * Callers read the guidance off it with `carriedInstructions` from
+ * `@uipath/common` — duck-typed, because each packager bundles its own copy of
+ * this class and `instanceof` does not survive the trip between bundles.
+ */
+export declare class GovernancePolicyError extends Error {
+    readonly instructions: string;
+    name: string;
+    constructor(message: string, instructions: string);
 }
 export declare class GovernancePolicyService implements IGovernancePolicyService {
     private readonly fileSystem;
@@ -9,10 +43,29 @@ export declare class GovernancePolicyService implements IGovernancePolicyService
     private readonly fetchFn;
     private readonly logger;
     constructor(fileSystem: IFileSystem, temporaryStorage: ITemporaryStorageService, fetchFn?: typeof fetch);
-    resolveGovernancePolicyAsync(validateOptions: ValidateOptions, connectionInfo?: ConnectionInfo, cancellationToken?: AbortSignal): Promise<void>;
-    private downloadPolicyAsync;
+    resolveGovernancePolicyAsync(validateOptions: ValidateOptions, connectionInfo?: ConnectionInfo, cancellationToken?: AbortSignal, usage?: GovernanceUsage): Promise<void>;
+    private applyResolutionAsync;
+    private savePolicyAsync;
+    /**
+     * Say what could not be resolved, then carry on with the rules shipped
+     * with the WorkflowCompiler.
+     *
+     * Not knowing whether a tenant is governed is not the same as knowing it
+     * is not, and the warning is what keeps the two apart for anyone reading
+     * the log. It is deliberately not an exit code: breaking a build because
+     * the policy service was briefly unreachable would be a worse bug than
+     * the silent fallback this replaces.
+     */
+    private warnAndUseShippedRules;
+    /**
+     * The reason, the detail, the URL asked, and the wait the server asked for
+     * when it named one — everything needed to tell a bad minute apart from a
+     * misconfigured product without turning the log into a stack trace.
+     */
+    private describeUnknown;
+    private resolveCloudOrigin;
     /**
-     * Resolves the license type to use in the policy download URL.
+     * Resolves the license type to use in the policy request.
      *
      * Calls the Orchestrator AcquireLicense endpoint to get the user's robotType.
      * The robotType enum names (Development, Attended, StudioPro, etc.) are the

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

@@ -1,3 +1,21 @@
+/**
+ * Marker on the error {@link PackService.sanitizePackageId} throws when the id
+ * it was handed is longer than NuGet allows.
+ *
+ * A `code` property rather than a class the caller checks with `instanceof`:
+ * every tool bundles its own copy of this package, so class identity does not
+ * survive a bundle boundary while a duck-typed field does. Same reason the
+ * cross-bundle singletons in `@uipath/common` are duck-typed.
+ */
+export declare const PACKAGE_ID_TOO_LONG = "PACKAGE_ID_TOO_LONG";
+export interface PackageIdTooLongError extends Error {
+    code: typeof PACKAGE_ID_TOO_LONG;
+    /** The sanitized id, as it would have been published. */
+    packageId: string;
+    maxLength: number;
+}
+/** True when `error` is the failure {@link PackService.sanitizePackageId} raises for an over-long id. */
+export declare function isPackageIdTooLongError(error: unknown): error is PackageIdTooLongError;
 /**
  * Interface for NuGet package operations
  */

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

@@ -1,4 +1,4 @@
-import type { ITelemetryService } from "@uipath/common";
+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";

package/dist/tests/public-surface.spec.d.ts

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

package/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@uipath/project-packager",
+    "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.202.0",
+    "version": "1.203.0-preview.160",
     "description": "UiPath Project Packager - core library for packing individual UiPath projects",
     "type": "module",
     "main": "./dist/index.js",
@@ -32,12 +33,13 @@
         "dist"
     ],
     "dependencies": {
-        "@uipath/filesystem": "1.202.0",
-        "@uipath/solutionpackager-tool-core": "1.202.0",
-        "@uipath/common": "1.202.0"
+        "@uipath/aops-policy-sdk": "1.203.0",
+        "@uipath/filesystem": "1.203.0",
+        "@uipath/solutionpackager-tool-core": "1.203.0",
+        "@uipath/common": "1.203.0"
     },
     "peerDependencies": {
         "fflate": "^0.8.2"
     },
-    "gitHead": "23b5a7038ead7264439af18f8b807c7cc99a29d5"
+    "gitHead": "3a42062ba731afca4595ba9aa8a80afc9667528d"
 }