@uipath/solutionpackager-tool-core 1.202.0 → 1.203.0-preview.160

package/dist/filesystem/zip-service.d.ts

@@ -16,10 +16,19 @@ export interface IZipService {
      * @returns The compressed zip data
      */
     compressAsync(sourcePath: string): Promise<Uint8Array>;
+    /**
+     * Create a zip archive from entries already in memory, for contents that are not a directory on
+     * disk. Paths are used verbatim.
+     *
+     * @param entries Archive-relative path to file contents
+     * @returns The compressed zip data
+     */
+    compressEntries(entries: Record<string, Uint8Array>): Uint8Array;
 }
 export declare class ZipService implements IZipService {
     private readonly fileSystem;
     constructor(fileSystem: IFileSystem);
     extractAsync(zipData: Uint8Array, targetPath: string): Promise<string[]>;
     compressAsync(sourcePath: string): Promise<Uint8Array>;
+    compressEntries(entries: Record<string, Uint8Array>): Uint8Array;
 }

package/dist/index.js

@@ -154,6 +154,9 @@ class ZipService {
     });
     return zipData;
   }
+  compressEntries(entries) {
+    return zipSync(entries, { level: 6 });
+  }
 }
 // src/i18n/types.ts
 function isPluralForm(value) {
@@ -1590,4 +1593,4 @@ export {
   writeOrBackfillOperateProjectId
 };
 
-//# debugId=F1773888C0CB0BBF64756E2164756E21
+//# debugId=CF4CC11EA66D137864756E2164756E21

package/dist/services/index.d.ts

@@ -4,6 +4,7 @@ export type { INugetPackager, NugetPackagerResult } from "./nuget-packager.js";
 export { NugetPackager } from "./nuget-packager.js";
 export { ensureProjectId, ensureProjectIdInOperateFile, writeOrBackfillOperateProjectId, } from "./project-id.js";
 export type { ProjectOperationContext } from "./project-operation-context.js";
+export type { ProjectContributionError, ProjectResourceContribution, ProjectSpecPatch, } from "./project-resource-contribution.js";
 export { ProjectTool } from "./project-tool.js";
 export type { IProjectToolFactory } from "./project-tool-factory.js";
 export { SolutionTool } from "./solution-tool.js";

package/dist/services/project-resource-contribution.d.ts

@@ -0,0 +1,53 @@
+/**
+ * What a project contributes to its solution's resources.
+ *
+ * Plain data on purpose: a contributor sees its own project directory and a
+ * filesystem, and returns JSON. It never sees the `.uipx`, the on-disk
+ * resource format, or `@uipath/resource-builder-sdk` types — solution-tool's
+ * driver owns all of that (AGENTS.md Hard Rule #19).
+ */
+export interface ProjectContributionError {
+    /** What is wrong. Becomes the failure envelope's `Message`. */
+    message: string;
+    /** What to run or change next. Becomes `Instructions`. Never the same text. */
+    instructions?: string;
+    /**
+     * Failure mode, e.g. "action_schema_missing". The envelope's `ErrorCode`
+     * is the closed CLI set and reports every contributed error as
+     * `invalid_argument`; this code surfaces as `Context.errorCode` when the
+     * batch agrees on one.
+     */
+    code?: string;
+}
+export interface ProjectSpecPatch {
+    /** Artefact resource kind this patch targets, e.g. "app", "process". */
+    kind: string;
+    /**
+     * Spec keys to set on that resource. A `null` value **deletes** the key —
+     * that is how a contributor removes a key it wrote on an earlier run and
+     * no longer owns. Any other value is written as-is.
+     */
+    values: Record<string, unknown>;
+}
+export interface ProjectResourceContribution {
+    /** Blocking problems. Any entry fails `solution pack`. */
+    errors?: ProjectContributionError[];
+    /** Spec keys to persist onto this project's artefact resources. */
+    specPatch?: ProjectSpecPatch[];
+    /**
+     * The SDK-facing subType this project's artefact resources are generated
+     * from — the `${subType}` half of the resource-builder's template table's
+     * `${type}_${subType}` row.
+     *
+     * Only the owning tool can know it: it lives in a file format that tool
+     * owns, not in `project.uiproj` or the `.uipx`. The host forwards the
+     * string into `reconcileProjectsAsync` without interpreting it, which is
+     * what keeps a project type's variants out of solution-tool and
+     * solution-sdk (AGENTS.md Hard Rule #19).
+     *
+     * Omit it for a type whose bare `type` row already resolves a template —
+     * reconcile is inert for a project it gets no subType for, so a wrong
+     * value is worse than none.
+     */
+    projectSubType?: string;
+}

package/dist/services/project-tool-factory.d.ts

@@ -1,6 +1,7 @@
 import type { IFileSystem } from "../filesystem/file-system.js";
 import type { ProjectType } from "../models/project-type.js";
 import type { ProjectOperationContext } from "./project-operation-context.js";
+import type { ProjectResourceContribution } from "./project-resource-contribution.js";
 import type { ProjectTool } from "./project-tool.js";
 import type { IToolLogger } from "./tool-logger.js";
 /**
@@ -18,4 +19,15 @@ export interface IProjectToolFactory {
      * @param context - Optional operation context with id and sibling project info
      */
     createAsync(logger: IToolLogger, fileSystem: IFileSystem, context?: ProjectOperationContext): Promise<ProjectTool>;
+    /**
+     * Describe what this project contributes to its solution's resources.
+     * Called with the project's own directory; implementations read only files
+     * they own and return plain data — no `.uipx`, no resource JSON.
+     *
+     * Optional so every existing factory stays valid. A registered factory
+     * without it is reported by the caller, not silently skipped: tool bundles
+     * version independently of the host, so a missing method means "the
+     * installed tool is older than this host", which the user has to hear.
+     */
+    describeResourcesAsync?(projectDir: string, fileSystem: IFileSystem): Promise<ProjectResourceContribution>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uipath/solutionpackager-tool-core",
-    "version": "1.202.0",
+    "version": "1.203.0-preview.160",
     "description": "UiPath contracts for solution packager tools",
     "type": "module",
     "exports": {
@@ -13,7 +13,7 @@
     "files": [
         "dist"
     ],
-    "author": "",
+    "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
     "repository": {
         "type": "git",
@@ -24,8 +24,8 @@
         "registry": "https://registry.npmjs.org/"
     },
     "dependencies": {
-        "@uipath/filesystem": "1.202.0",
+        "@uipath/filesystem": "1.203.0",
         "fflate": "^0.8.2"
     },
-    "gitHead": "23b5a7038ead7264439af18f8b807c7cc99a29d5"
+    "gitHead": "3a42062ba731afca4595ba9aa8a80afc9667528d"
 }