@salesforce/packaging 0.0.7 → 0.0.10

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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.10](https://github.com/forcedotcom/packaging/compare/v0.0.9...v0.0.10) (2022-07-26)
+
+### Bug Fixes
+
+- add pv report and pvc report ([d5b69be](https://github.com/forcedotcom/packaging/commit/d5b69be112915e8ee885ef88a8e65ffa2e3d8a0f))
+
+### [0.0.9](https://github.com/forcedotcom/packaging/compare/v0.0.8...v0.0.9) (2022-07-19)
+
+### Features
+
+- add package1Display method for use with package1:version:display command ([ef3df30](https://github.com/forcedotcom/packaging/commit/ef3df309147bafb16367c957981a04470c6ad7df))
+
+### [0.0.8](https://github.com/forcedotcom/packaging/compare/v0.0.7...v0.0.8) (2022-07-18)
+
+### Features
+
+- add package1VersionDisplayGet method ([0de1b9e](https://github.com/forcedotcom/packaging/commit/0de1b9e730dc1dc18c68f4efa7bbc2e2b0b43807))
+
 ### [0.0.7](https://github.com/forcedotcom/packaging/compare/v0.0.6...v0.0.7) (2022-07-14)
 
 ### Bug Fixes

package/lib/interfaces/packagingInterfacesAndType.d.ts

@@ -32,7 +32,6 @@ export interface IPackageVersion2GP {
     update(): Promise<void>;
 }
 export declare type PackageOptions = Record<string, unknown>;
-export declare type PackageVersion2Options = Record<string, unknown>;
 export declare type PackageVersionOptions1GP = Record<string, unknown>;
 export declare type PackageVersionCreateRequestResult = {
     Id: string;
@@ -47,6 +46,7 @@ export declare type PackageVersionCreateRequestResult = {
     HasMetadataRemoved: boolean | null;
     CreatedBy: string;
 };
+export declare const PackageVersionCreateRequestResultInProgressStatuses: PackagingSObjects.Package2VersionStatus[];
 export declare type PackageVersionCreateRequestError = {
     Message: string;
 };
@@ -92,6 +92,14 @@ export declare type PackageVersionListResult = {
     BuildDurationInSeconds?: number;
     HasMetadataRemoved?: boolean;
 };
+export declare type Package1Display = {
+    MetadataPackageVersionId: string;
+    MetadataPackageId: string;
+    Name: string;
+    Version: string;
+    ReleaseState: string;
+    BuildNumber: number;
+};
 export declare type PackageType = 'Managed' | 'Unlocked';
 export declare type PackageCreateOptions = {
     name: string;
@@ -158,6 +166,7 @@ export declare type PackageVersionCreateOptions = Partial<PackageVersionOptions
     versionname: string;
     versionnumber: string;
     wait: Duration;
+    pollInterval: Duration;
     profileApi: PackageProfileApi;
 }>;
 export declare type PackageVersionCreateRequestQueryOptions = {
@@ -170,3 +179,12 @@ export declare type ProfileApiOptions = {
     includeUserLicenses: boolean;
     generateProfileInformation: boolean;
 };
+export declare type PackageVersionReportResult = Partial<PackagingSObjects.Package2Version> & {
+    Package2: Partial<PackagingSObjects.Package2>;
+    SubscriberPackageVersion?: Pick<PackagingSObjects.SubscriberPackageVersion, 'Dependencies'>;
+    Version: string;
+    AncestorVersion?: string;
+};
+export declare type PackageVersionCreateReportProgress = PackageVersionCreateRequestResult & {
+    remainingWaitTime: Duration;
+};

package/lib/interfaces/packagingInterfacesAndType.js

@@ -6,4 +6,8 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageVersionCreateRequestResultInProgressStatuses = void 0;
+const packagingSObjects_1 = require("./packagingSObjects");
+var Package2VersionStatus = packagingSObjects_1.PackagingSObjects.Package2VersionStatus;
+exports.PackageVersionCreateRequestResultInProgressStatuses = Object.values(Package2VersionStatus).filter((status) => !['Queued', 'Success', 'Error'].includes(status));
 //# sourceMappingURL=packagingInterfacesAndType.js.map

package/lib/interfaces/packagingSObjects.d.ts

@@ -53,7 +53,12 @@ export declare namespace PackagingSObjects {
         queued = "Queued",
         inProgress = "InProgress",
         success = "Success",
-        error = "Error"
+        error = "Error",
+        initializing = "Initializing",
+        verifyingFeaturesAndSettings = "VerifyingFeaturesAndSettings",
+        verifyingDependencies = "VerifyingDependencies",
+        verifyingMetadata = "VerifyingMetadata",
+        finalizingPackageVersion = "FinalizingPackageVersion"
     }
     type Package2VersionCreateRequest = {
         Id: string;
@@ -94,6 +99,25 @@ export declare namespace PackagingSObjects {
         Description: string;
         IsPackageValid: boolean;
     };
+    type SubscriberPackageDestinationProfile = {
+        description: string;
+        displayName: string;
+        name: string;
+        noAccess: boolean;
+        profileId: string;
+        type: string;
+    };
+    type SubscriberPackageSourceProfile = {
+        label: string;
+        value: string;
+    };
+    type SubscriberPackageProfiles = {
+        destinationProfiles: SubscriberPackageDestinationProfile[];
+        sourceProfiles: SubscriberPackageSourceProfile[];
+    };
+    type SubscriberPackageDependencies = {
+        ids: string[];
+    };
     type SubscriberPackageVersion = {
         Id: string;
         SubscriberPackageId: string;
@@ -120,8 +144,8 @@ export declare namespace PackagingSObjects {
         PostInstallUrl: string;
         RemoteSiteSettings: unknown;
         CspTrustedSites: unknown;
-        Profiles: unknown;
-        Dependencies: unknown;
+        Profiles: SubscriberPackageProfiles;
+        Dependencies: SubscriberPackageDependencies;
         InstallValidationStatus: string;
     };
     type SubscriberPackageVersionUninstallRequest = {
@@ -223,4 +247,15 @@ export declare namespace PackagingSObjects {
         SubscriberPackageVersionId: string;
         MinPackageVersionId: string;
     };
+    type MetadataPackageVersion = {
+        Id: string;
+        MetadataPackageId: string;
+        Name: string;
+        ReleaseState: 'Beta' | 'Released';
+        MajorVersion: number;
+        MinorVersion: number;
+        PatchVersion: number;
+        BuildNumber: number;
+        IsDeprecated: boolean;
+    };
 }

package/lib/interfaces/packagingSObjects.js

@@ -9,6 +9,11 @@ var PackagingSObjects;
         Package2VersionStatus["inProgress"] = "InProgress";
         Package2VersionStatus["success"] = "Success";
         Package2VersionStatus["error"] = "Error";
+        Package2VersionStatus["initializing"] = "Initializing";
+        Package2VersionStatus["verifyingFeaturesAndSettings"] = "VerifyingFeaturesAndSettings";
+        Package2VersionStatus["verifyingDependencies"] = "VerifyingDependencies";
+        Package2VersionStatus["verifyingMetadata"] = "VerifyingMetadata";
+        Package2VersionStatus["finalizingPackageVersion"] = "FinalizingPackageVersion";
     })(Package2VersionStatus = PackagingSObjects.Package2VersionStatus || (PackagingSObjects.Package2VersionStatus = {}));
 })(PackagingSObjects = exports.PackagingSObjects || (exports.PackagingSObjects = {}));
 //# sourceMappingURL=packagingSObjects.js.map

package/lib/package/packageCreate.js

@@ -32,7 +32,6 @@ exports._createPackageRequestFromContext = _createPackageRequestFromContext;
  * @private
  */
 function _generatePackageDirEntry(project, options) {
-    var _a, _b;
     let packageDirs = project.getPackageDirectories();
     if (!packageDirs) {
         packageDirs = [];
@@ -47,8 +46,8 @@ function _generatePackageDirEntry(project, options) {
     if (packageDir) {
         // update existing entry
         packageDir.package = options.name;
-        (_a = packageDir.versionName) !== null && _a !== void 0 ? _a : (packageDir.versionName = pkgUtils.DEFAULT_PACKAGE_DIR.versionName);
-        (_b = packageDir.versionNumber) !== null && _b !== void 0 ? _b : (packageDir.versionNumber = pkgUtils.DEFAULT_PACKAGE_DIR.versionNumber);
+        packageDir.versionName ?? (packageDir.versionName = pkgUtils.DEFAULT_PACKAGE_DIR.versionName);
+        packageDir.versionNumber ?? (packageDir.versionNumber = pkgUtils.DEFAULT_PACKAGE_DIR.versionNumber);
         // set as default if this is the only entry or no other entry is the default
         if (!Reflect.getOwnPropertyDescriptor(packageDir, 'default')) {
             packageDir.default = !pkgUtils.getConfigPackageDirectory(packageDirs, 'default', true);
@@ -97,7 +96,7 @@ async function createPackage(connection, project, options) {
     }
     packageId = createResult.id;
     const queryResult = await connection.tooling.query(`SELECT Id FROM Package2 WHERE Id='${packageId}'`);
-    if (!(queryResult === null || queryResult === void 0 ? void 0 : queryResult.records[0])) {
+    if (!queryResult?.records[0]) {
         throw messages.createError('unableToFindPackageWithId', [packageId]);
     }
     const record = queryResult.records[0];

package/lib/package/packageVersion.d.ts

@@ -1,4 +1,5 @@
-import { PackageVersionCreateRequestResult, PackageSaveResult, PackageVersionCreateOptions, PackageVersionOptions } from '../interfaces';
+import { Duration } from '@salesforce/kit';
+import { PackageVersionCreateRequestResult, PackageSaveResult, PackageVersionCreateOptions, PackageVersionOptions, PackageVersionReportResult } from '../interfaces';
 export declare class PackageVersion {
     private options;
     private readonly project;
@@ -14,12 +15,42 @@ export declare class PackageVersion {
      * Deletes a package version.
      *
      * @param idOrAlias
-     * @param undelete
      */
-    delete(idOrAlias: string, undelete?: boolean): Promise<PackageSaveResult>;
+    delete(idOrAlias: string): Promise<PackageSaveResult>;
+    /**
+     * Undeletes a package version.
+     *
+     * @param idOrAlias
+     */
+    undelete(idOrAlias: string): Promise<PackageSaveResult>;
+    /**
+     * Gets the package version report.
+     *
+     * @param createPackageRequestId
+     * @param verbose
+     */
+    report(createPackageRequestId: string, verbose?: boolean): Promise<PackageVersionReportResult>;
+    /**
+     * Gets current state of a package version create request.
+     *
+     * @param createPackageRequestId
+     */
+    getCreateVersionReport(createPackageRequestId: string): Promise<PackageVersionCreateRequestResult>;
+    /**
+     * Convenience function that will wait for a package version to be created.
+     *
+     * 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 createPackageVersionRequestId
+     * @param wait - how long to wait for the package version to be created
+     * @param interval - frequency of checking for the package version to be created
+     */
+    waitForCreateVersion(createPackageVersionRequestId: string, wait?: Duration, interval?: Duration): Promise<PackageVersionCreateRequestResult>;
     convert(): Promise<void>;
     install(): Promise<void>;
     list(): Promise<void>;
     uninstall(): Promise<void>;
     update(): Promise<void>;
+    private updateDeprecation;
 }

package/lib/package/packageVersion.js

@@ -8,9 +8,12 @@
 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 utils_1 = require("../utils");
 const packageVersionCreate_1 = require("./packageVersionCreate");
+const packageVersionReport_1 = require("./packageVersionReport");
+const packageVersionCreateRequestReport_1 = require("./packageVersionCreateRequestReport");
 core_1.Messages.importMessagesDirectory(__dirname);
 // const messages = Messages.loadMessages('@salesforce/packaging', 'messages');
 // const logger = Logger.childFromRoot('packageVersionCreate');
@@ -27,31 +30,122 @@ class PackageVersion {
      */
     async create(options) {
         const pvc = new packageVersionCreate_1.PackageVersionCreate({ ...options, ...this.options });
-        return pvc.createPackageVersion();
+        const createResult = await pvc.createPackageVersion();
+        const waitResult = await this.waitForCreateVersion(createResult.Id, options.wait ?? kit_1.Duration.milliseconds(0), options.pollInterval ? options.pollInterval : kit_1.Duration.seconds(30)).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);
+        });
+        return waitResult;
     }
     /**
      * Deletes a package version.
      *
      * @param idOrAlias
-     * @param undelete
      */
-    async delete(idOrAlias, undelete = false) {
-        const packageVersionId = pkgUtils.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);
-        // lookup the 05i ID, if needed
-        const packageId = await pkgUtils.getPackageVersionId(packageVersionId, this.connection);
-        // setup the request
-        const request = {
-            Id: packageId,
-            IsDeprecated: !undelete,
-        };
-        const updateResult = await this.connection.tooling.update('Package2Version', request);
-        if (!updateResult.success) {
-            throw (0, utils_1.combineSaveErrors)('Package2', 'update', updateResult.errors);
+    async delete(idOrAlias) {
+        return this.updateDeprecation(idOrAlias, true);
+    }
+    /**
+     * Undeletes a package version.
+     *
+     * @param idOrAlias
+     */
+    async undelete(idOrAlias) {
+        return this.updateDeprecation(idOrAlias, false);
+    }
+    /**
+     * Gets the package version report.
+     *
+     * @param createPackageRequestId
+     * @param verbose
+     */
+    async report(createPackageRequestId, verbose = false) {
+        const results = await (0, packageVersionReport_1.getPackageVersionReport)({
+            idOrAlias: createPackageRequestId,
+            connection: this.connection,
+            project: this.project,
+            verbose,
+        }).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);
+        });
+        return results[0];
+    }
+    /**
+     * Gets current state of a package version create request.
+     *
+     * @param createPackageRequestId
+     */
+    async getCreateVersionReport(createPackageRequestId) {
+        return await (0, packageVersionCreateRequestReport_1.getCreatePackageVersionCreateRequestReport)({
+            createPackageVersionRequestId: createPackageRequestId,
+            connection: this.connection,
+        }).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);
+        });
+    }
+    /**
+     * Convenience function that will wait for a package version to be created.
+     *
+     * 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 createPackageVersionRequestId
+     * @param wait - how long to wait for the package version to be created
+     * @param interval - frequency of checking for the package version to be created
+     */
+    async waitForCreateVersion(createPackageVersionRequestId, wait = kit_1.Duration.milliseconds(0), interval = kit_1.Duration.milliseconds(0)) {
+        if (wait?.milliseconds <= 0) {
+            const result = await this.getCreateVersionReport(createPackageVersionRequestId);
+            return result;
+        }
+        let remainingWaitTime = wait;
+        let report;
+        const pollingClient = await core_1.PollingClient.create({
+            poll: async () => {
+                report = await this.getCreateVersionReport(createPackageVersionRequestId);
+                switch (report.Status) {
+                    case 'Queued':
+                        await core_1.Lifecycle.getInstance().emit('enqueued', { ...report, remainingWaitTime });
+                        remainingWaitTime = kit_1.Duration.seconds(remainingWaitTime.seconds - interval.seconds);
+                        return {
+                            completed: false,
+                            payload: report,
+                        };
+                    case 'InProgress':
+                    case 'Initializing':
+                    case 'VerifyingFeaturesAndSettings':
+                    case 'VerifyingDependencies':
+                    case 'VerifyingMetadata':
+                    case 'FinalizingPackageVersion':
+                        await core_1.Lifecycle.getInstance().emit('in-progress', { ...report, remainingWaitTime });
+                        remainingWaitTime = kit_1.Duration.seconds(remainingWaitTime.seconds - interval.seconds);
+                        return {
+                            completed: false,
+                            payload: report,
+                        };
+                    case 'Success':
+                        await core_1.Lifecycle.getInstance().emit('success', report);
+                        return { completed: true, payload: report };
+                    case 'Error':
+                        await core_1.Lifecycle.getInstance().emit('error', report);
+                        return { completed: true, payload: report };
+                }
+            },
+            frequency: interval,
+            timeout: wait,
+        });
+        try {
+            return pollingClient.subscribe();
+        }
+        catch (err) {
+            await core_1.Lifecycle.getInstance().emit('timed-out', report);
+            throw pkgUtils.applyErrorAction(err);
         }
-        updateResult.id = await pkgUtils.getSubscriberPackageVersionId(packageVersionId, this.connection);
-        return updateResult;
     }
     convert() {
         return Promise.resolve(undefined);
@@ -68,6 +162,24 @@ class PackageVersion {
     update() {
         return Promise.resolve(undefined);
     }
+    async updateDeprecation(idOrAlias, IsDeprecated) {
+        const packageVersionId = pkgUtils.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);
+        // lookup the 05i ID, if needed
+        const packageId = await pkgUtils.getPackageVersionId(packageVersionId, this.connection);
+        // setup the request
+        const request = {
+            Id: packageId,
+            IsDeprecated,
+        };
+        const updateResult = await this.connection.tooling.update('Package2Version', request);
+        if (!updateResult.success) {
+            throw (0, utils_1.combineSaveErrors)('Package2', 'update', updateResult.errors);
+        }
+        updateResult.id = await pkgUtils.getSubscriberPackageVersionId(packageVersionId, this.connection);
+        return updateResult;
+    }
 }
 exports.PackageVersion = PackageVersion;
 //# sourceMappingURL=packageVersion.js.map

package/lib/package/packageVersionCreate.js

@@ -48,8 +48,7 @@ class PackageVersionCreate {
     }
     // convert source to mdapi format and copy to tmp dir packaging up
     async generateMDFolderForArtifact(options) {
-        var _a;
-        const sourcepath = (_a = options.sourcePaths) !== null && _a !== void 0 ? _a : [options.sourceDir];
+        const sourcepath = options.sourcePaths ?? [options.sourceDir];
         const componentSet = await source_deploy_retrieve_1.ComponentSetBuilder.build({
             sourceapiversion: this.project.getSfProjectJson().get('sourceApiVersion'),
             sourcepath,
@@ -558,22 +557,13 @@ class PackageVersionCreate {
         return value;
     }
     async packageVersionCreate(options) {
-        var _a, _b;
-        let pollInterval = kit_1.Duration.seconds(pkgUtils.POLL_INTERVAL_SECONDS);
-        let maxRetries = 0;
-        if (((_a = options.wait) === null || _a === void 0 ? void 0 : _a.milliseconds) > 0) {
-            if (options.skipvalidation === true) {
-                pollInterval = kit_1.Duration.seconds(POLL_INTERVAL_WITHOUT_VALIDATION_SECONDS);
-            }
-            maxRetries = (60 / pollInterval.seconds) * options.wait.seconds;
-        }
         // For the first rollout of validating sfdx-project.json data against schema, make it optional and defaulted
         // to false. Validation only occurs if the hidden -j (--validateschema) flag has been specified.
         if (options.validateschema) {
             await this.project.getSfProjectJson().schemaValidate();
         }
         // Check for empty packageDirectories
-        if (((_b = this.project.getPackageDirectories()) === null || _b === void 0 ? void 0 : _b.length) === 0) {
+        if (this.project.getPackageDirectories()?.length === 0) {
             throw messages.createError('errorEmptyPackageDirs');
         }
         const canonicalPackageProperty = this.resolveCanonicalPackageProperty(options);
@@ -590,7 +580,6 @@ class PackageVersionCreate {
             throw messages.createError('directoryDoesNotExist', [options.path]);
         }
         options.profileApi = await this.resolveUserLicenses(canonicalPackageProperty, options);
-        [pollInterval, maxRetries] = await this.resolveOrgDependentPollingTime(resolvedPackageId, options, pollInterval, maxRetries);
         const request = await this.createPackageVersionCreateRequestFromOptions(options, resolvedPackageId, versionNumberString);
         const createResult = await this.connection.tooling.create('Package2VersionCreateRequest', request);
         if (!createResult.success) {
@@ -600,17 +589,16 @@ class PackageVersionCreate {
                 errStr.toString(),
             ]);
         }
-        let result;
-        if (options.wait && options.wait.milliseconds > 0) {
-            pollInterval = pollInterval !== null && pollInterval !== void 0 ? pollInterval : kit_1.Duration.seconds(options.wait.seconds / maxRetries);
-            if (pollInterval) {
-                result = await pkgUtils.pollForStatusWithInterval(createResult.id, maxRetries, resolvedPackageId, options.branch, this.project, this.connection, pollInterval);
+        let pollInterval = kit_1.Duration.seconds(pkgUtils.POLL_INTERVAL_SECONDS);
+        let maxRetries = 0;
+        if (options.wait?.milliseconds > 0) {
+            if (options.skipvalidation === true) {
+                pollInterval = kit_1.Duration.seconds(POLL_INTERVAL_WITHOUT_VALIDATION_SECONDS);
             }
+            maxRetries = (60 / pollInterval.seconds) * options.wait.seconds;
         }
-        else {
-            result = (await this.listRequestById(createResult.id, this.connection))[0];
-        }
-        return result;
+        [pollInterval, maxRetries] = await this.resolveOrgDependentPollingTime(resolvedPackageId, options, pollInterval, maxRetries);
+        return (await this.listRequestById(createResult.id, this.connection))[0];
     }
     resolveCanonicalPackageProperty(options) {
         let canonicalPackageProperty;

package/lib/package/packageVersionCreateRequestReport.d.ts

@@ -0,0 +1,6 @@
+import { Connection } from '@salesforce/core';
+import { PackageVersionCreateRequestResult } from '../interfaces';
+export declare function getCreatePackageVersionCreateRequestReport(options: {
+    createPackageVersionRequestId: string;
+    connection: Connection;
+}): Promise<PackageVersionCreateRequestResult>;

package/lib/package/packageVersionCreateRequestReport.js

@@ -0,0 +1,18 @@
+"use strict";
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCreatePackageVersionCreateRequestReport = void 0;
+const pkgUtils = require("../utils/packageUtils");
+const packageVersionCreateRequest_1 = require("./packageVersionCreateRequest");
+async function getCreatePackageVersionCreateRequestReport(options) {
+    pkgUtils.validateId(pkgUtils.BY_LABEL.PACKAGE_VERSION_CREATE_REQUEST_ID, options.createPackageVersionRequestId);
+    const results = await (0, packageVersionCreateRequest_1.byId)(options.createPackageVersionRequestId, options.connection);
+    return results[0];
+}
+exports.getCreatePackageVersionCreateRequestReport = getCreatePackageVersionCreateRequestReport;
+//# sourceMappingURL=packageVersionCreateRequestReport.js.map

package/lib/package/packageVersionList.js

@@ -51,7 +51,7 @@ exports._assembleQueryParts = _assembleQueryParts;
 function _constructWhere(idsOrAliases, createdLastDays, lastModLastDays, project) {
     const where = [];
     // filter on given package ids
-    if ((idsOrAliases === null || idsOrAliases === void 0 ? void 0 : idsOrAliases.length) > 0) {
+    if (idsOrAliases?.length > 0) {
         // remove dups
         const aliasesOrIds = [...new Set(idsOrAliases)];
         // resolve any aliases

package/lib/package/packageVersionReport.d.ts

@@ -0,0 +1,8 @@
+import { Connection, SfProject } from '@salesforce/core';
+import { PackageVersionReportResult } from '../interfaces';
+export declare function getPackageVersionReport(options: {
+    idOrAlias: string;
+    connection: Connection;
+    project: SfProject;
+    verbose: boolean;
+}): Promise<PackageVersionReportResult[]>;

package/lib/package/packageVersionReport.js

@@ -0,0 +1,70 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageVersionReport = void 0;
+// Node
+const util = require("util");
+// Local
+const core_1 = require("@salesforce/core");
+const pkgUtils = require("../utils/packageUtils");
+const QUERY = 'SELECT Package2Id, SubscriberPackageVersionId, Name, Description, Tag, Branch, AncestorId, ValidationSkipped, ' +
+    'MajorVersion, MinorVersion, PatchVersion, BuildNumber, IsReleased, CodeCoverage, HasPassedCodeCoverageCheck, ' +
+    'Package2.IsOrgDependent, ReleaseVersion, BuildDurationInSeconds, HasMetadataRemoved, CreatedById ' +
+    'FROM Package2Version ' +
+    "WHERE Id = '%s' AND IsDeprecated != true " +
+    'ORDER BY Package2Id, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber';
+// verbose adds: Id, ConvertedFromVersionId, SubscriberPackageVersion.Dependencies
+const QUERY_VERBOSE = 'SELECT Id, Package2Id, SubscriberPackageVersionId, Name, Description, Tag, Branch, AncestorId, ValidationSkipped, ' +
+    'MajorVersion, MinorVersion, PatchVersion, BuildNumber, IsReleased, CodeCoverage, HasPassedCodeCoverageCheck, ConvertedFromVersionId, ' +
+    'Package2.IsOrgDependent, ReleaseVersion, BuildDurationInSeconds, HasMetadataRemoved, SubscriberPackageVersion.Dependencies, ' +
+    'CreatedById, CodeCoveragePercentages ' +
+    'FROM Package2Version ' +
+    "WHERE Id = '%s' AND IsDeprecated != true " +
+    'ORDER BY Package2Id, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber';
+const logger = core_1.Logger.childFromRoot('getPackageVersionReport');
+async function getPackageVersionReport(options) {
+    logger.debug(`entering getPackageVersionReport(${util.inspect(options, { depth: null })})`);
+    let packageVersionId = pkgUtils.getPackageIdFromAlias(options.idOrAlias, options.project);
+    // ID can be an 04t or 05i
+    pkgUtils.validateId([pkgUtils.BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID, pkgUtils.BY_LABEL.PACKAGE_VERSION_ID], packageVersionId);
+    // lookup the 05i ID, if needed
+    packageVersionId = await pkgUtils.getPackageVersionId(packageVersionId, options.connection);
+    const queryResult = await options.connection.tooling.query(util.format(options.verbose ? QUERY_VERBOSE : QUERY, packageVersionId));
+    const records = queryResult.records;
+    if (records && records.length > 0) {
+        const record = records[0];
+        record.Version = [record.MajorVersion, record.MinorVersion, record.PatchVersion, record.BuildNumber].join('.');
+        const containerOptions = await pkgUtils.getContainerOptions([record.Package2Id], options.connection);
+        const packageType = containerOptions.get(record.Package2Id);
+        let ancestorVersion = null;
+        if (record.AncestorId) {
+            // lookup AncestorVersion value
+            const ancestorVersionMap = await pkgUtils.getPackageVersionStrings([record.AncestorId], options.connection);
+            ancestorVersion = ancestorVersionMap.get(record.AncestorId);
+        }
+        else {
+            // otherwise display 'N/A' if package is Unlocked Packages
+            if (packageType !== 'Managed') {
+                ancestorVersion = null;
+                record.AncestorId = null;
+            }
+        }
+        record.HasPassedCodeCoverageCheck =
+            record.Package2.IsOrgDependent === true || record.ValidationSkipped === true
+                ? null
+                : record.HasPassedCodeCoverageCheck;
+        record.Package2.IsOrgDependent = packageType === 'Managed' ? null : !!record.Package2.IsOrgDependent;
+        // set HasMetadataRemoved to null Unlocked, otherwise use existing value
+        record.HasMetadataRemoved = packageType !== 'Managed' ? null : !!record.HasMetadataRemoved;
+        record.AncestorVersion = ancestorVersion;
+        return records;
+    }
+    return [];
+}
+exports.getPackageVersionReport = getPackageVersionReport;
+//# sourceMappingURL=packageVersionReport.js.map

package/lib/package1/index.d.ts

@@ -1 +1,3 @@
 export * from './packageVersion1GP';
+export * from './packageDisplay';
+export * from './package1VersionCreateGet';

package/lib/package1/index.js

@@ -21,4 +21,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 __exportStar(require("./packageVersion1GP"), exports);
+__exportStar(require("./packageDisplay"), exports);
+__exportStar(require("./package1VersionCreateGet"), exports);
 //# sourceMappingURL=index.js.map

package/lib/package1/package1VersionCreateGet.d.ts

@@ -0,0 +1,3 @@
+import { Connection } from '@salesforce/core';
+import { PackagingSObjects } from '../interfaces';
+export declare function package1VersionCreateGet(connection: Connection, id: string): Promise<PackagingSObjects.PackageUploadRequest>;

package/lib/package1/package1VersionCreateGet.js

@@ -0,0 +1,16 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.package1VersionCreateGet = void 0;
+async function package1VersionCreateGet(connection, id) {
+    return (await connection.tooling
+        .sobject('PackageUploadRequest')
+        .retrieve(id));
+}
+exports.package1VersionCreateGet = package1VersionCreateGet;
+//# sourceMappingURL=package1VersionCreateGet.js.map

package/lib/package1/packageDisplay.d.ts

@@ -0,0 +1,9 @@
+import { Connection } from '@salesforce/core';
+import { Package1Display } from '../interfaces';
+/**
+ * Executes server-side logic for the package1:display command
+ *
+ * @param connection
+ * @param id: id of the MetadataPackageVersion sObject
+ */
+export declare function package1Display(connection: Connection, id: string): Promise<Package1Display[]>;

package/lib/package1/packageDisplay.js

@@ -0,0 +1,29 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.package1Display = void 0;
+/**
+ * Executes server-side logic for the package1:display command
+ *
+ * @param connection
+ * @param id: id of the MetadataPackageVersion sObject
+ */
+async function package1Display(connection, id) {
+    const query = `SELECT Id,MetadataPackageId,Name,ReleaseState,MajorVersion,MinorVersion,PatchVersion,BuildNumber FROM MetadataPackageVersion WHERE id = '${id}'`;
+    const results = (await connection.tooling.query(query)).records;
+    return results.map((result) => ({
+        MetadataPackageVersionId: result.Id,
+        MetadataPackageId: result.MetadataPackageId,
+        Name: result.Name,
+        ReleaseState: result.ReleaseState,
+        Version: `${result.MajorVersion}.${result.MinorVersion}.${result.PatchVersion}`,
+        BuildNumber: result.BuildNumber,
+    }));
+}
+exports.package1Display = package1Display;
+//# sourceMappingURL=packageDisplay.js.map

package/lib/utils/packageUtils.d.ts

@@ -1,4 +1,4 @@
-import { Connection, NamedPackageDir, PackageDir, SfError, SfProject } from '@salesforce/core';
+import { Connection, NamedPackageDir, PackageDir, SfdcUrl, SfError, SfProject } from '@salesforce/core';
 import { Duration } from '@salesforce/kit';
 import { Many } from '@salesforce/ts-types';
 import { SaveError } from 'jsforce';
@@ -11,7 +11,7 @@ export declare type IdRegistryValue = {
 export declare type IdRegistry = {
     [key: string]: IdRegistryValue;
 };
-export declare const INSTALL_URL_BASE = "https://login.salesforce.com/packaging/installPackage.apexp?p0=";
+export declare const INSTALL_URL_BASE: SfdcUrl;
 export declare const SOQL_WHERE_CLAUSE_MAX_LENGTH = 4000;
 export declare const POLL_INTERVAL_SECONDS = 30;
 export declare const DEFAULT_PACKAGE_DIR: {

package/lib/utils/packageUtils.js

@@ -36,7 +36,7 @@ const ID_REGISTRY = [
         label: 'Subscriber Package Version Id',
     },
 ];
-exports.INSTALL_URL_BASE = 'https://login.salesforce.com/packaging/installPackage.apexp?p0=';
+exports.INSTALL_URL_BASE = new core_1.SfdcUrl('https://login.salesforce.com/packaging/installPackage.apexp?p0=');
 // https://developer.salesforce.com/docs/atlas.en-us.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_soslsoql.htm
 exports.SOQL_WHERE_CLAUSE_MAX_LENGTH = 4000;
 exports.POLL_INTERVAL_SECONDS = 30;
@@ -195,7 +195,7 @@ exports.applyErrorAction = applyErrorAction;
  */
 async function getPackageVersionId(versionId, connection) {
     // if it's already a 05i return it, otherwise query for it
-    if (versionId === null || versionId === void 0 ? void 0 : versionId.startsWith(exports.BY_LABEL.PACKAGE_VERSION_ID.prefix)) {
+    if (versionId?.startsWith(exports.BY_LABEL.PACKAGE_VERSION_ID.prefix)) {
         return versionId;
     }
     const query = `SELECT Id FROM Package2Version WHERE SubscriberPackageVersionId = '${versionId}'`;
@@ -410,9 +410,8 @@ exports.getInClauseItemsCount = getInClauseItemsCount;
 async function getAncestorId(packageDescriptorJson, connection, project, versionNumberString, skipAncestorCheck) {
     // eslint-disable-next-line complexity
     return Promise.resolve().then(async () => {
-        var _a;
         // If an id property is present, use it.  Otherwise, look up the package id from the package property.
-        const packageId = (_a = packageDescriptorJson['id']) !== null && _a !== void 0 ? _a : getPackageIdFromAlias(packageDescriptorJson.package, project);
+        const packageId = packageDescriptorJson['id'] ?? getPackageIdFromAlias(packageDescriptorJson.package, project);
         // No need to proceed if Unlocked
         const packageType = await getPackageType(packageId, connection);
         if (packageType === 'Unlocked') {
@@ -540,7 +539,7 @@ async function getAncestorIdHighestRelease(connection, packageId, versionNumberS
             'ORDER BY MajorVersion Desc, MinorVersion Desc, PatchVersion Desc, BuildNumber Desc LIMIT 1';
         const majorMinorVersionResult = await connection.tooling.query(query);
         const majorMinorVersionRecords = majorMinorVersionResult.records;
-        if (majorMinorVersionRecords && (majorMinorVersionRecords === null || majorMinorVersionRecords === void 0 ? void 0 : majorMinorVersionRecords.length) === 1 && majorMinorVersionRecords[0]) {
+        if (majorMinorVersionRecords && majorMinorVersionRecords?.length === 1 && majorMinorVersionRecords[0]) {
             result.finalAncestorId = majorMinorVersionRecords[0].Id;
         }
         else {
@@ -587,7 +586,7 @@ function getConfigPackageDirectories(project) {
 }
 exports.getConfigPackageDirectories = getConfigPackageDirectories;
 function getConfigPackageDirectory(packageDirs, lookupProperty, lookupValue) {
-    return packageDirs === null || packageDirs === void 0 ? void 0 : packageDirs.find((pkgDir) => pkgDir[lookupProperty] === lookupValue);
+    return packageDirs?.find((pkgDir) => pkgDir[lookupProperty] === lookupValue);
 }
 exports.getConfigPackageDirectory = getConfigPackageDirectory;
 /**
@@ -619,7 +618,7 @@ exports.convertCamelCaseStringToSentence = convertCamelCaseStringToSentence;
  * @returns an array of alias for the given id.
  */
 function getPackageAliasesFromId(packageId, project) {
-    const packageAliases = (project === null || project === void 0 ? void 0 : project.getSfProjectJson().getContents().packageAliases) || {};
+    const packageAliases = project?.getSfProjectJson().getContents().packageAliases || {};
     // check for a matching alias
     return Object.entries(packageAliases)
         .filter((alias) => alias[1] === packageId)
@@ -664,7 +663,6 @@ async function pollForStatusWithInterval(id, retries, packageId, branch, withPro
     let remainingRetries = retries;
     const pollingClient = await core_1.PollingClient.create({
         poll: async () => {
-            var _a;
             const results = await pvcr.byId(id, connection);
             if (_isStatusEqualTo(results, [Package2VersionStatus.success, Package2VersionStatus.error])) {
                 // complete
@@ -693,7 +691,7 @@ async function pollForStatusWithInterval(id, retries, packageId, branch, withPro
                 }
                 else {
                     let status = 'Unknown Error';
-                    if ((results === null || results === void 0 ? void 0 : results.length) > 0 && results[0].Error.length > 0) {
+                    if (results?.length > 0 && results[0].Error.length > 0) {
                         const errors = [];
                         // for multiple errors, display one per line prefixed with (x)
                         if (results[0].Error.length > 1) {
@@ -716,7 +714,7 @@ async function pollForStatusWithInterval(id, retries, packageId, branch, withPro
                     message: '',
                     remainingTime,
                 });
-                logger.info(`Request in progress. Sleeping ${interval} seconds. Will wait a total of ${remainingTime.seconds} more seconds before timing out. Current Status='${convertCamelCaseStringToSentence((_a = results[0]) === null || _a === void 0 ? void 0 : _a.Status)}'`);
+                logger.info(`Request in progress. Sleeping ${interval} seconds. Will wait a total of ${remainingTime.seconds} more seconds before timing out. Current Status='${convertCamelCaseStringToSentence(results[0]?.Status)}'`);
                 remainingRetries--;
                 return { completed: false, payload: results[0] };
             }
@@ -747,7 +745,7 @@ async function _generatePackageAliasEntry(connection, project, packageVersionId,
         const query = `SELECT Name FROM Package2 WHERE Id = '${packageId}'`;
         packageName = await connection.tooling
             .query(query)
-            .then((pkgQueryResult) => { var _a; return (_a = pkgQueryResult.records[0]) === null || _a === void 0 ? void 0 : _a.Name; });
+            .then((pkgQueryResult) => pkgQueryResult.records[0]?.Name);
     }
     else {
         packageName = aliasForPackageId[0];
@@ -766,7 +764,7 @@ async function _generatePackageAliasEntry(connection, project, packageVersionId,
  * @returns {boolean} if one of the values in status is found.
  */
 function _isStatusEqualTo(results, statuses) {
-    return (results === null || results === void 0 ? void 0 : results.length) <= 0 ? false : statuses === null || statuses === void 0 ? void 0 : statuses.some((status) => results[0].Status === status);
+    return results?.length <= 0 ? false : statuses?.some((status) => results[0].Status === status);
 }
 // added for unit testing
 function getSoqlWhereClauseMaxLength() {
@@ -782,8 +780,7 @@ function formatDate(date) {
 exports.formatDate = formatDate;
 function combineSaveErrors(sObject, crudOperation, errors) {
     const errorMessages = errors.map((error) => {
-        var _a;
-        const fieldsString = ((_a = error.fields) === null || _a === void 0 ? void 0 : _a.length) > 0 ? `Fields: [${error.fields.join(', ')}]` : '';
+        const fieldsString = error.fields?.length > 0 ? `Fields: [${error.fields.join(', ')}]` : '';
         return `Error: ${error.errorCode} Message: ${error.message} ${fieldsString}`;
     });
     const sfError = messages.createError('errorDuringSObjectCRUDOperation', [

package/lib/utils/versionNumber.js

@@ -30,7 +30,7 @@ class VersionNumber {
             throw messages.createError('errorMissingVersionNumber');
         }
         const version = versionString.split('.');
-        if ((version === null || version === void 0 ? void 0 : version.length) === 4) {
+        if (version?.length === 4) {
             const [major, minor, patch, build] = version;
             const asNumbers = [major, minor, patch, build].map((v) => parseInt(v, 10));
             if (asNumbers.slice(0, 3).some((v) => isNaN(v))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/packaging",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "description": "packing libraries to Salesforce packaging platform",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",
@@ -43,13 +43,15 @@
     "debug": "^4.3.4",
     "globby": "^11",
     "js2xmlparser": "^4.0.2",
-    "jsforce": "2.0.0-beta.14",
+    "jsforce": "beta",
+    "mkdirp": "1.0.4",
+    "ts-retry-promise": "^0.6.1",
     "jszip": "^3.10.0",
     "xml2js": "^0.4.23",
     "xmldom-sfdx-encoding": "^0.1.30"
   },
   "devDependencies": {
-    "@salesforce/cli-plugins-testkit": "^2.3.0",
+    "@salesforce/cli-plugins-testkit": "^2.3.4",
     "@salesforce/dev-config": "^3.0.1",
     "@salesforce/dev-scripts": "^2.0.2",
     "@salesforce/prettier-config": "^0.0.2",