@salesforce/packaging 0.0.21 → 0.0.22

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.22](https://github.com/forcedotcom/packaging/compare/v0.0.21...v0.0.22) (2022-08-22)
+
+### Bug Fixes
+
+- add package.promote method ([de5867b](https://github.com/forcedotcom/packaging/commit/de5867bc45850ca2040e4e929a2149a7a146c93f))
+
 ### [0.0.21](https://github.com/forcedotcom/packaging/compare/v0.0.20...v0.0.21) (2022-08-19)
 
 ### Bug Fixes

package/lib/package/package.d.ts

@@ -1,8 +1,7 @@
 import { AsyncCreatable, Duration } from '@salesforce/kit';
 import { QueryResult } from 'jsforce';
 import { Optional } from '@salesforce/ts-types';
-import { IPackage, PackageOptions, PackagingSObjects } from '../interfaces';
-import { PackageInstallOptions, PackageInstallCreateRequest, PackageIdType } from '../interfaces/packagingInterfacesAndType';
+import { IPackage, PackageOptions, PackagingSObjects, PackageInstallOptions, PackageInstallCreateRequest, PackageIdType } from '../interfaces';
 declare type PackageInstallRequest = PackagingSObjects.PackageInstallRequest;
 /**
  * Package class.

package/lib/package/packageVersion.d.ts

@@ -46,6 +46,7 @@ export declare class PackageVersion {
      * This function emits LifeCycle events, "enqueued", "in-progress", "success", "error" and "timed-out" to
      * progress and current status. Events also carry a payload of type PackageVersionCreateRequestResult.
      *
+     * @param packageId - The package id to wait for
      * @param createPackageVersionRequestId
      * @param polling frequency and timeout Durations to be used in polling
      * */
@@ -57,6 +58,7 @@ export declare class PackageVersion {
     install(): Promise<void>;
     list(): Promise<void>;
     uninstall(): Promise<void>;
+    promote(id: string): Promise<PackageSaveResult>;
     update(): Promise<void>;
     private updateDeprecation;
     private updateProjectWithPackageVersion;

package/lib/package/packageVersion.js

@@ -9,8 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PackageVersion = void 0;
 const core_1 = require("@salesforce/core");
 const kit_1 = require("@salesforce/kit");
-const pkgUtils = require("../utils/packageUtils");
-const packageUtils_1 = require("../utils/packageUtils");
+const utils_1 = require("../utils");
 const packageVersionCreate_1 = require("./packageVersionCreate");
 const packageVersionReport_1 = require("./packageVersionReport");
 const packageVersionCreateRequestReport_1 = require("./packageVersionCreateRequestReport");
@@ -37,7 +36,7 @@ class PackageVersion {
         return await this.waitForCreateVersion(createResult.Id, polling).catch((err) => {
             // TODO
             // until package2 is GA, wrap perm-based errors w/ 'contact sfdc' action (REMOVE once package2 is GA'd)
-            throw pkgUtils.applyErrorAction(err);
+            throw (0, utils_1.applyErrorAction)(err);
         });
     }
     /**
@@ -71,7 +70,7 @@ class PackageVersion {
         }).catch((err) => {
             // TODO
             // until package2 is GA, wrap perm-based errors w/ 'contact sfdc' action (REMOVE once package2 is GA'd)
-            throw pkgUtils.applyErrorAction(err);
+            throw (0, utils_1.applyErrorAction)(err);
         });
         return results[0];
     }
@@ -87,7 +86,7 @@ class PackageVersion {
         }).catch((err) => {
             // TODO
             // until package2 is GA, wrap perm-based errors w/ 'contact sfdc' action (REMOVE once package2 is GA'd)
-            throw pkgUtils.applyErrorAction(err);
+            throw (0, utils_1.applyErrorAction)(err);
         });
     }
     /**
@@ -96,6 +95,7 @@ class PackageVersion {
      * This function emits LifeCycle events, "enqueued", "in-progress", "success", "error" and "timed-out" to
      * progress and current status. Events also carry a payload of type PackageVersionCreateRequestResult.
      *
+     * @param packageId - The package id to wait for
      * @param createPackageVersionRequestId
      * @param polling frequency and timeout Durations to be used in polling
      * */
@@ -134,7 +134,7 @@ class PackageVersion {
                         if (!process.env.SFDX_PROJECT_AUTOUPDATE_DISABLE_FOR_PACKAGE_CREATE) {
                             // get the newly created package version from the server
                             const versionResult = (await this.connection.tooling.query(`SELECT Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber FROM Package2Version WHERE SubscriberPackageVersionId='${report.SubscriberPackageVersionId}'`)).records[0];
-                            const version = `${(0, packageUtils_1.getPackageAliasesFromId)(report.Package2Id, this.project).join()}@${versionResult.MajorVersion ?? 0}.${versionResult.MinorVersion ?? 0}.${versionResult.PatchVersion ?? 0}`;
+                            const version = `${(0, utils_1.getPackageAliasesFromId)(report.Package2Id, this.project).join()}@${versionResult.MajorVersion ?? 0}.${versionResult.MinorVersion ?? 0}.${versionResult.PatchVersion ?? 0}`;
                             const build = versionResult.BuildNumber ? `-${versionResult.BuildNumber}` : '';
                             const branch = versionResult.Branch ? `-${versionResult.Branch}` : '';
                             // set packageAliases entry '<package>@<major>.<minor>.<patch>-<build>-<branch>: <result.subscriberPackageVersionId>'
@@ -156,7 +156,7 @@ class PackageVersion {
         }
         catch (err) {
             await core_1.Lifecycle.getInstance().emit('timed-out', report);
-            throw pkgUtils.applyErrorAction(err);
+            throw (0, utils_1.applyErrorAction)(err);
         }
     }
     convert() {
@@ -171,15 +171,22 @@ class PackageVersion {
     uninstall() {
         return Promise.resolve(undefined);
     }
+    async promote(id) {
+        // lookup the 05i ID, if needed
+        if (id.startsWith('04t')) {
+            id = await (0, utils_1.getPackageVersionId)(id, this.connection);
+        }
+        return await this.options.connection.tooling.update('Package2Version', { IsReleased: true, Id: id });
+    }
     update() {
         return Promise.resolve(undefined);
     }
     async updateDeprecation(idOrAlias, IsDeprecated) {
-        const packageVersionId = pkgUtils.getPackageIdFromAlias(idOrAlias, this.project);
+        const packageVersionId = (0, utils_1.getPackageIdFromAlias)(idOrAlias, this.project);
         // ID can be an 04t or 05i
-        pkgUtils.validateId([pkgUtils.BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID, pkgUtils.BY_LABEL.PACKAGE_VERSION_ID], packageVersionId);
+        (0, utils_1.validateId)([utils_1.BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID, utils_1.BY_LABEL.PACKAGE_VERSION_ID], packageVersionId);
         // lookup the 05i ID, if needed
-        const packageId = await pkgUtils.getPackageVersionId(packageVersionId, this.connection);
+        const packageId = await (0, utils_1.getPackageVersionId)(packageVersionId, this.connection);
         // setup the request
         const request = {
             Id: packageId,
@@ -187,9 +194,9 @@ class PackageVersion {
         };
         const updateResult = await this.connection.tooling.update('Package2Version', request);
         if (!updateResult.success) {
-            throw (0, packageUtils_1.combineSaveErrors)('Package2', 'update', updateResult.errors);
+            throw (0, utils_1.combineSaveErrors)('Package2', 'update', updateResult.errors);
         }
-        updateResult.id = await pkgUtils.getSubscriberPackageVersionId(packageVersionId, this.connection);
+        updateResult.id = await (0, utils_1.getSubscriberPackageVersionId)(packageVersionId, this.connection);
         return updateResult;
     }
     async updateProjectWithPackageVersion(withProject, results) {
@@ -200,14 +207,14 @@ class PackageVersion {
             });
             const packageVersionVersionString = `${packageVersion.MajorVersion}.${packageVersion.MinorVersion}.${packageVersion.PatchVersion}.${packageVersion.BuildNumber}`;
             await this.generatePackageDirectory(packageVersion, withProject, packageVersionVersionString);
-            const newConfig = await (0, packageUtils_1.generatePackageAliasEntry)(this.connection, withProject, packageVersion.SubscriberPackageVersionId, packageVersionVersionString, packageVersion.Branch, packageVersion.Package2Id);
+            const newConfig = await (0, utils_1.generatePackageAliasEntry)(this.connection, withProject, packageVersion.SubscriberPackageVersionId, packageVersionVersionString, packageVersion.Branch, packageVersion.Package2Id);
             withProject.getSfProjectJson().set('packageAliases', newConfig);
             await withProject.getSfProjectJson().write();
         }
     }
     async generatePackageDirectory(packageVersion, withProject, packageVersionVersionString) {
         const pkg = await (await package_1.Package.create({ connection: this.connection })).getPackage(packageVersion.Package2Id);
-        const pkgDir = (0, packageUtils_1.getConfigPackageDirectory)(withProject.getPackageDirectories(), 'id', pkg.Id) ?? {};
+        const pkgDir = (0, utils_1.getConfigPackageDirectory)(withProject.getPackageDirectories(), 'id', pkg.Id) ?? {};
         pkgDir.versionNumber = packageVersionVersionString;
         pkgDir.versionDescription = packageVersion.Description;
         const packageDirs = withProject.getPackageDirectories().map((pd) => (pkgDir['id'] === pd['id'] ? pkgDir : pd));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/packaging",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "packing libraries to Salesforce packaging platform",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",
@@ -35,8 +35,8 @@
     "!lib/**/*.map"
   ],
   "dependencies": {
-    "@salesforce/core": "^3.26.1",
-    "@salesforce/kit": "^1.5.44",
+    "@salesforce/core": "^3.26.2",
+    "@salesforce/kit": "^1.6.0",
     "@salesforce/schemas": "^1.2.0",
     "@salesforce/source-deploy-retrieve": "^6.2.0",
     "@salesforce/ts-types": "^1.5.20",