@uipath/packager-tool-connector 0.0.18 → 1.197.0-preview.64

package/dist/connector-tool.d.ts

@@ -15,6 +15,18 @@ export declare class ConnectorTool extends ProjectTool {
     buildAsync(options: IProjectBuildOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
     packAsync(options: IProjectPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     dispose(): Promise<void>;
+    private createOperateFile;
+    /**
+     * Anchor the connector's projectId in a source-side project.json so
+     * repeated direct packs (no projectStorageId from a solution) reuse
+     * the same id. ensureProjectId only persists into files that already
+     * exist; connector projects typically have neither operate.json nor
+     * project.json, so we scaffold project.json on first pack. The file
+     * stays out of the nupkg because the build copies only the `app/`
+     * subfolder.
+     */
+    private resolveConnectorProjectId;
+    private createPackageDescriptor;
     /**
      * Recursively copy a directory and its contents
      */

package/dist/index.d.ts

@@ -1 +1 @@
-export {};
+export { ConnectorToolFactory } from "./connector-tool-factory.js";

package/dist/index.js

@@ -1,20 +1,20 @@
-// src/index.ts
-import { toolsFactoryRepository } from "@uipath/solutionpackager-tool-core";
-
 // src/connector-tool-factory.ts
 import {
-  ProjectTypes
+  ProjectTypes as ProjectTypes2
 } from "@uipath/solutionpackager-tool-core";
 
 // src/connector-tool.ts
 import {
+  ensureProjectId,
   NugetConstants,
   NugetPackager,
   Path,
   ProjectTool,
+  ProjectTypes,
   TemporaryStorageService,
   ToolErrorCodes,
-  ToolResult
+  ToolResult,
+  writeOrBackfillOperateProjectId
 } from "@uipath/solutionpackager-tool-core";
 
 class ConnectorTool extends ProjectTool {
@@ -40,6 +40,10 @@ class ConnectorTool extends ProjectTool {
     try {
       this.logger.progress("Copying app folder...");
       await this.copyDirectory(appProjectFolder, destinationFolder);
+      this.logger.progress("Creating operate.json file...");
+      await this.createOperateFile(options, localBuildFolder);
+      this.logger.progress("Creating package-descriptor.json file...");
+      await this.createPackageDescriptor(localBuildFolder);
       return new ToolResult(ToolErrorCodes.Success, "done", [
         localBuildFolder
       ]);
@@ -77,6 +81,48 @@ class ConnectorTool extends ProjectTool {
       await this._temporaryStorage.cleanup();
     } catch {}
   }
+  async createOperateFile(options, localBuildFolder) {
+    const contentFolder = Path.join(localBuildFolder, NugetConstants.ContentFolderName);
+    const operateJsonFilePath = Path.join(contentFolder, NugetConstants.OperateFileName);
+    const projectId = options.projectStorageId ?? await this.resolveConnectorProjectId(options.projectPath);
+    await writeOrBackfillOperateProjectId(operateJsonFilePath, projectId, this.fileSystem, () => this.fileSystem.writeFile(operateJsonFilePath, JSON.stringify({
+      $schema: "https://cloud.uipath.com/draft/2024-12/operate",
+      contentType: ProjectTypes.Connector,
+      projectId,
+      main: "",
+      targetFramework: "Portable",
+      runtimeOptions: {
+        isAttended: false,
+        requiresUserInteraction: false
+      }
+    }, null, 2)));
+  }
+  async resolveConnectorProjectId(projectPath) {
+    const operatePath = Path.join(projectPath, "operate.json");
+    const projectFilePath = Path.join(projectPath, "project.json");
+    const hasAnchor = await this.fileSystem.exists(operatePath) || await this.fileSystem.exists(projectFilePath);
+    if (hasAnchor) {
+      return ensureProjectId(projectPath, this.fileSystem);
+    }
+    const id = crypto.randomUUID();
+    await this.fileSystem.writeFile(projectFilePath, `${JSON.stringify({ projectId: id }, null, 2)}
+`);
+    return id;
+  }
+  async createPackageDescriptor(localBuildFolder) {
+    const packageDescriptorPath = Path.join(localBuildFolder, NugetConstants.ContentFolderName, NugetConstants.PackageDescriptorFileName);
+    const exists = await this.fileSystem.exists(packageDescriptorPath);
+    if (exists) {
+      return;
+    }
+    const descriptor = {
+      $schema: "https://cloud.uipath.com/draft/2024-12/package-descriptor",
+      files: {
+        [NugetConstants.OperateFileName]: Path.join(NugetConstants.ContentFolderName, NugetConstants.OperateFileName)
+      }
+    };
+    await this.fileSystem.writeFile(packageDescriptorPath, JSON.stringify(descriptor, null, 2));
+  }
   async copyDirectory(sourcePath, destinationPath) {
     await this.fileSystem.mkdir(destinationPath);
     const entries = await this.fileSystem.readdir(sourcePath);
@@ -98,11 +144,13 @@ class ConnectorTool extends ProjectTool {
 
 // src/connector-tool-factory.ts
 class ConnectorToolFactory {
-  supportedTypes = [ProjectTypes.Connector];
+  supportedTypes = [ProjectTypes2.Connector];
   async createAsync(logger, fileSystem) {
     return new ConnectorTool(fileSystem, logger);
   }
 }
+export {
+  ConnectorToolFactory
+};
 
-// src/index.ts
-toolsFactoryRepository.registerProjectToolFactory(new ConnectorToolFactory);
+//# debugId=1CB272CEF003511564756E2164756E21

package/package.json

@@ -1,59 +1,31 @@
 {
-    "name": "@uipath/packager-tool-connector",
-    "version": "0.0.18",
-    "description": "UiPath Connector tool implementation",
-    "type": "module",
-    "exports": {
-        ".": {
-            "source": "./src/index.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/UiPath/cli.git",
-        "directory": "packages/packager/packager-tool-connector"
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
-    },
-    "types": "./dist/index.d.ts",
-    "scripts": {
-        "build": "bun build ./src/index.ts --outdir dist --format esm --target browser --external @uipath/solutionpackager-tool-core && tsc --emitDeclarationOnly --outDir dist",
-        "dev": "bun build ./src/index.ts --outdir dist --format esm --target browser --external @uipath/solutionpackager-tool-core --watch",
-        "test": "vitest run",
-        "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 ."
-    },
-    "files": [
-        "dist",
-        "!dist/**/*.map",
-        "src"
-    ],
-    "author": "",
-    "license": "ISC",
-    "peerDependencies": {
-        "@uipath/solutionpackager-tool-core": "0.0.33"
-    },
-    "devDependencies": {
-        "@types/node": "^25.5.0",
-        "@uipath/solutionpackager-tool-core": "0.0.33",
-        "@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",
-        "vitest": "^4.0.14"
-    },
-    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
+  "name": "@uipath/packager-tool-connector",
+  "version": "1.197.0-preview.64",
+  "description": "UiPath Connector tool implementation",
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UiPath/cli.git",
+    "directory": "packages/packager/packager-tool-connector"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "@uipath/solutionpackager-tool-core": "1.197.0"
+  },
+  "gitHead": "3977b977945bf519336258da69fd271433eaaef4"
 }

package/src/connector-tool.ts

@@ -5,15 +5,18 @@ import type {
     IProjectValidateOptions,
 } from "@uipath/solutionpackager-tool-core";
 import {
+    ensureProjectId,
     type IFileSystem,
     type IToolLogger,
     NugetConstants,
     NugetPackager,
     Path,
     ProjectTool,
+    ProjectTypes,
     TemporaryStorageService,
     ToolErrorCodes,
     ToolResult,
+    writeOrBackfillOperateProjectId,
 } from "@uipath/solutionpackager-tool-core";
 
 /**
@@ -74,6 +77,12 @@ export class ConnectorTool extends ProjectTool {
             this.logger.progress("Copying app folder...");
             await this.copyDirectory(appProjectFolder, destinationFolder);
 
+            this.logger.progress("Creating operate.json file...");
+            await this.createOperateFile(options, localBuildFolder);
+
+            this.logger.progress("Creating package-descriptor.json file...");
+            await this.createPackageDescriptor(localBuildFolder);
+
             return new ToolResult(ToolErrorCodes.Success, "done", [
                 localBuildFolder,
             ]);
@@ -138,6 +147,112 @@ export class ConnectorTool extends ProjectTool {
         }
     }
 
+    private async createOperateFile(
+        options: IProjectBuildOptions,
+        localBuildFolder: string,
+    ): Promise<void> {
+        const contentFolder = Path.join(
+            localBuildFolder,
+            NugetConstants.ContentFolderName,
+        );
+        const operateJsonFilePath = Path.join(
+            contentFolder,
+            NugetConstants.OperateFileName,
+        );
+
+        const projectId =
+            options.projectStorageId ??
+            (await this.resolveConnectorProjectId(options.projectPath));
+
+        await writeOrBackfillOperateProjectId(
+            operateJsonFilePath,
+            projectId,
+            this.fileSystem,
+            // Connector packages bundle content/app/ as the unit; no single
+            // entry file, so main is intentionally empty.
+            () =>
+                this.fileSystem.writeFile(
+                    operateJsonFilePath,
+                    JSON.stringify(
+                        {
+                            $schema:
+                                "https://cloud.uipath.com/draft/2024-12/operate",
+                            contentType: ProjectTypes.Connector,
+                            projectId,
+                            main: "",
+                            targetFramework: "Portable",
+                            runtimeOptions: {
+                                isAttended: false,
+                                requiresUserInteraction: false,
+                            },
+                        },
+                        null,
+                        2,
+                    ),
+                ),
+        );
+    }
+
+    /**
+     * Anchor the connector's projectId in a source-side project.json so
+     * repeated direct packs (no projectStorageId from a solution) reuse
+     * the same id. ensureProjectId only persists into files that already
+     * exist; connector projects typically have neither operate.json nor
+     * project.json, so we scaffold project.json on first pack. The file
+     * stays out of the nupkg because the build copies only the `app/`
+     * subfolder.
+     */
+    private async resolveConnectorProjectId(
+        projectPath: string,
+    ): Promise<string> {
+        const operatePath = Path.join(projectPath, "operate.json");
+        const projectFilePath = Path.join(projectPath, "project.json");
+        const hasAnchor =
+            (await this.fileSystem.exists(operatePath)) ||
+            (await this.fileSystem.exists(projectFilePath));
+        if (hasAnchor) {
+            return ensureProjectId(projectPath, this.fileSystem);
+        }
+
+        const id = crypto.randomUUID();
+        await this.fileSystem.writeFile(
+            projectFilePath,
+            `${JSON.stringify({ projectId: id }, null, 2)}\n`,
+        );
+        return id;
+    }
+
+    private async createPackageDescriptor(
+        localBuildFolder: string,
+    ): Promise<void> {
+        const packageDescriptorPath = Path.join(
+            localBuildFolder,
+            NugetConstants.ContentFolderName,
+            NugetConstants.PackageDescriptorFileName,
+        );
+
+        const exists = await this.fileSystem.exists(packageDescriptorPath);
+        if (exists) {
+            return;
+        }
+
+        const descriptor = {
+            $schema:
+                "https://cloud.uipath.com/draft/2024-12/package-descriptor",
+            files: {
+                [NugetConstants.OperateFileName]: Path.join(
+                    NugetConstants.ContentFolderName,
+                    NugetConstants.OperateFileName,
+                ),
+            },
+        };
+
+        await this.fileSystem.writeFile(
+            packageDescriptorPath,
+            JSON.stringify(descriptor, null, 2),
+        );
+    }
+
     /**
      * Recursively copy a directory and its contents
      */

package/src/index.ts

@@ -1,5 +1,3 @@
-// Self-register Connector tool factory with the singleton repository
-import { toolsFactoryRepository } from "@uipath/solutionpackager-tool-core";
-import { ConnectorToolFactory } from "./connector-tool-factory.js";
-
-toolsFactoryRepository.registerProjectToolFactory(new ConnectorToolFactory());
+// Connector tool factory. Consumers register it explicitly via
+// `toolsFactoryRepository.registerProjectToolFactory(new ConnectorToolFactory())`.
+export { ConnectorToolFactory } from "./connector-tool-factory.js";