@salesforce/packaging 0.0.9 → 0.0.12

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.12](https://github.com/forcedotcom/packaging/compare/v0.0.11...v0.0.12) (2022-07-29)
+
+### Features
+
+- add package1VersionCreate command, refactor tests, allow .test.ts ([aa34e8c](https://github.com/forcedotcom/packaging/commit/aa34e8cfe4ad865bb299baa6db51b2af22454a86))
+
+### [0.0.11](https://github.com/forcedotcom/packaging/compare/v0.0.10...v0.0.11) (2022-07-27)
+
+### Bug Fixes
+
+- add package1 version list query, UTs ([302653b](https://github.com/forcedotcom/packaging/commit/302653b8bd355d59aa0efbcc2f226ab4dff82baa))
+
+### [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

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;
 };
@@ -166,6 +166,7 @@ export declare type PackageVersionCreateOptions = Partial<PackageVersionOptions
     versionname: string;
     versionnumber: string;
     wait: Duration;
+    pollInterval: Duration;
     profileApi: PackageProfileApi;
 }>;
 export declare type PackageVersionCreateRequestQueryOptions = {
@@ -178,3 +179,13 @@ 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;
+};
+export declare type Package1VersionCreateRequest = Pick<PackagingSObjects.PackageUploadRequest, 'VersionName'> & Partial<Pick<PackagingSObjects.PackageUploadRequest, 'MetadataPackageId' | 'Description' | 'MajorVersion' | 'MinorVersion' | 'IsReleaseVersion' | 'ReleaseNotesUrl' | 'PostInstallUrl' | 'Password'>>;

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 = {

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/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

@@ -557,14 +557,6 @@ class PackageVersionCreate {
         return value;
     }
     async packageVersionCreate(options) {
-        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;
-        }
         // 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) {
@@ -588,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) {
@@ -598,17 +589,16 @@ class PackageVersionCreate {
                 errStr.toString(),
             ]);
         }
-        let result;
-        if (options.wait && options.wait.milliseconds > 0) {
-            pollInterval = 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/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,3 +1,5 @@
 export * from './packageVersion1GP';
 export * from './packageDisplay';
 export * from './package1VersionCreateGet';
+export * from './package1VersionCreate';
+export * from './package1VersionList';

package/lib/package1/index.js

@@ -23,4 +23,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./packageVersion1GP"), exports);
 __exportStar(require("./packageDisplay"), exports);
 __exportStar(require("./package1VersionCreateGet"), exports);
+__exportStar(require("./package1VersionCreate"), exports);
+__exportStar(require("./package1VersionList"), exports);
 //# sourceMappingURL=index.js.map

package/lib/package1/package1VersionCreate.d.ts

@@ -0,0 +1,7 @@
+import { Connection } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+import { Package1VersionCreateRequest, PackagingSObjects } from '../interfaces';
+export declare function package1VersionCreate(connection: Connection, options: Package1VersionCreateRequest, pollingOptions?: {
+    frequency: Duration;
+    timeout: Duration;
+}): Promise<PackagingSObjects.PackageUploadRequest>;

package/lib/package1/package1VersionCreate.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.package1VersionCreate = void 0;
+/*
+ * 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
+ */
+const os = require("os");
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/packaging', 'messages');
+const packageUploadRequestStatus = async (id, connection, timeout, frequency) => {
+    const pollingResult = await connection.tooling.sobject('PackageUploadRequest').retrieve(id);
+    switch (pollingResult.Status) {
+        case 'SUCCESS':
+            return { completed: true, payload: pollingResult };
+        case 'IN_PROGRESS':
+        case 'QUEUED':
+            timeout -= frequency;
+            await core_1.Lifecycle.getInstance().emit('package1VersionCreate:progress', { timeout, pollingResult });
+            return { completed: false, payload: pollingResult };
+        default: {
+            if (pollingResult?.Errors?.errors?.length > 0) {
+                throw messages.createError('package1VersionCreateCommandUploadFailure', [
+                    pollingResult.Errors.errors.map((e) => e.message).join(os.EOL),
+                ]);
+            }
+            else {
+                throw messages.createError('package1VersionCreateCommandUploadFailureDefault');
+            }
+        }
+    }
+};
+async function package1VersionCreate(connection, options, pollingOptions = { frequency: kit_1.Duration.seconds(5), timeout: kit_1.Duration.seconds(0) }) {
+    const createRequest = await connection.tooling.sobject('PackageUploadRequest').create(options);
+    if (pollingOptions.timeout.seconds) {
+        const timeout = pollingOptions.timeout.seconds;
+        const pollingClient = await core_1.PollingClient.create({
+            poll: () => packageUploadRequestStatus(createRequest.id, connection, timeout, pollingOptions.frequency.seconds),
+            ...pollingOptions,
+        });
+        return pollingClient.subscribe();
+    }
+    else {
+        // jsforce templates weren't working when setting the type to PackageUploadRequest, so we have to cast `as unknown as PackagingSObjects.PackageUploadRequest`
+        return (await connection.tooling
+            .sobject('PackageUploadRequest')
+            .retrieve(createRequest.id));
+    }
+}
+exports.package1VersionCreate = package1VersionCreate;
+//# sourceMappingURL=package1VersionCreate.js.map

package/lib/package1/package1VersionList.d.ts

@@ -0,0 +1,11 @@
+import { Connection } from '@salesforce/core';
+import { Package1Display } from '../interfaces';
+/**
+ * Lists package versions available in dev org. If package ID is supplied, only list versions of that package,
+ *  otherwise, list all package versions
+ *
+ * @param connection: sfdx-core Connection to the org
+ * @param metadataPackageId: optional, if present ID of package to list versions for (starts with 033)
+ * @returns Array of package version results
+ */
+export declare function package1VersionList(connection: Connection, metadataPackageId?: string): Promise<Package1Display[]>;

package/lib/package1/package1VersionList.js

@@ -0,0 +1,31 @@
+"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.package1VersionList = void 0;
+/**
+ * Lists package versions available in dev org. If package ID is supplied, only list versions of that package,
+ *  otherwise, list all package versions
+ *
+ * @param connection: sfdx-core Connection to the org
+ * @param metadataPackageId: optional, if present ID of package to list versions for (starts with 033)
+ * @returns Array of package version results
+ */
+async function package1VersionList(connection, metadataPackageId) {
+    const query = `SELECT Id,MetadataPackageId,Name,ReleaseState,MajorVersion,MinorVersion,PatchVersion,BuildNumber FROM MetadataPackageVersion ${metadataPackageId ? `WHERE MetadataPackageId = '${metadataPackageId}'` : ''} ORDER BY MetadataPackageId, MajorVersion, MinorVersion, PatchVersion, BuildNumber`;
+    const queryResult = await connection.tooling.query(query);
+    return queryResult.records?.map((record) => ({
+        MetadataPackageVersionId: record.Id,
+        MetadataPackageId: record.MetadataPackageId,
+        Name: record.Name,
+        ReleaseState: record.ReleaseState,
+        Version: `${record.MajorVersion}.${record.MinorVersion}.${record.PatchVersion}`,
+        BuildNumber: record.BuildNumber,
+    }));
+}
+exports.package1VersionList = package1VersionList;
+//# sourceMappingURL=package1VersionList.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;

package/messages/messages.md

@@ -238,3 +238,12 @@ Un-packaged metadata directory %s was specified but does not exist.
 # directoryDoesNotExist
 
 Directory %s does not exist.
+
+# package1VersionCreateCommandUploadFailureDefault
+
+Package version creation failed with unknown error
+
+# package1VersionCreateCommandUploadFailure
+
+Package upload failed.
+%s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/packaging",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "packing libraries to Salesforce packaging platform",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",