@salesforce/packaging 0.0.3 → 0.0.6

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.6](https://github.com/forcedotcom/packaging/compare/v0.0.5...v0.0.6) (2022-07-08)
+
+### Bug Fixes
+
+- add pkg create and delete apis ([dedc609](https://github.com/forcedotcom/packaging/commit/dedc609398da3aa2e23e9108b54a535a95e75bf8))
+- add pkg create and delete apis ([a1e37e2](https://github.com/forcedotcom/packaging/commit/a1e37e28e7886c451364413d0a47f3bfbda2b822))
+- bump version top 0.0.6 ([8d800f9](https://github.com/forcedotcom/packaging/commit/8d800f9264333362cfd0dae03c92d60f314aa098))
+
+### [0.0.5](https://github.com/forcedotcom/packaging/compare/v0.0.4...v0.0.5) (2022-07-06)
+
+### [0.0.4](https://github.com/forcedotcom/packaging/compare/v0.0.3...v0.0.4) (2022-06-23)
+
 ### [0.0.3](https://github.com/forcedotcom/packaging/compare/v0.0.2-test-02...v0.0.3) (2022-06-16)
 
 ### Bug Fixes

package/lib/constants.d.ts

@@ -0,0 +1,21 @@
+export declare const consts: {
+    DEFAULT_USER_DIR_MODE: string;
+    DEFAULT_USER_FILE_MODE: string;
+    DEFAULT_STREAM_TIMEOUT_MINUTES: number;
+    MIN_STREAM_TIMEOUT_MINUTES: number;
+    DEFAULT_SRC_WAIT_MINUTES: number;
+    DEFAULT_MDAPI_WAIT_MINUTES: number;
+    DEFAULT_MDAPI_RETRIEVE_WAIT_MINUTES: number;
+    DEFAULT_MDAPI_POLL_INTERVAL_MINUTES: number;
+    DEFAULT_MDAPI_POLL_INTERVAL_MILLISECONDS: number;
+    MIN_SRC_WAIT_MINUTES: number;
+    MIN_SRC_DEPLOY_WAIT_MINUTES: number;
+    WORKSPACE_CONFIG_FILENAME: string;
+    OLD_WORKSPACE_CONFIG_FILENAME: string;
+    DEFAULT_DEV_HUB_USERNAME: string;
+    DEFAULT_USERNAME: string;
+    ACKNOWLEDGED_USAGE_COLLECTION_FILENAME: string;
+    PACKAGE_VERSION_INFO_FILE_ZIP: string;
+    INSTANCE_URL_TOKEN: string;
+    PACKAGE2_DESCRIPTOR_FILE: string;
+};

package/lib/constants.js

@@ -0,0 +1,40 @@
+"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.consts = void 0;
+/* --------------------------------------------------------------------------------------------------------------------
+ * WARNING: This file has been deprecated and should now be considered locked against further changes.  Its contents
+ * have been partially or wholly superseded by functionality included in the @salesforce/core npm package, and exists
+ * now to service prior uses in this repository only until they can be ported to use the new @salesforce/core library.
+ *
+ * If you need or want help deciding where to add new functionality or how to migrate to the new library, please
+ * contact the CLI team at alm-cli@salesforce.com.
+ * ----------------------------------------------------------------------------------------------------------------- */
+exports.consts = {
+    DEFAULT_USER_DIR_MODE: '700',
+    DEFAULT_USER_FILE_MODE: '600',
+    DEFAULT_STREAM_TIMEOUT_MINUTES: 6,
+    MIN_STREAM_TIMEOUT_MINUTES: 2,
+    DEFAULT_SRC_WAIT_MINUTES: 33,
+    DEFAULT_MDAPI_WAIT_MINUTES: 0,
+    DEFAULT_MDAPI_RETRIEVE_WAIT_MINUTES: -1,
+    DEFAULT_MDAPI_POLL_INTERVAL_MINUTES: 0.1,
+    DEFAULT_MDAPI_POLL_INTERVAL_MILLISECONDS: 0.1 * 60 * 1000,
+    MIN_SRC_WAIT_MINUTES: 1,
+    MIN_SRC_DEPLOY_WAIT_MINUTES: 0,
+    WORKSPACE_CONFIG_FILENAME: 'sfdx-project.json',
+    OLD_WORKSPACE_CONFIG_FILENAME: 'sfdx-workspace.json',
+    DEFAULT_DEV_HUB_USERNAME: 'defaultdevhubusername',
+    DEFAULT_USERNAME: 'defaultusername',
+    ACKNOWLEDGED_USAGE_COLLECTION_FILENAME: 'acknowledgedUsageCollection.json',
+    PACKAGE_VERSION_INFO_FILE_ZIP: 'package-version-info.zip',
+    // tokens to be replaced on source:push
+    INSTANCE_URL_TOKEN: '__SFDX_INSTANCE_URL__',
+    PACKAGE2_DESCRIPTOR_FILE: 'package2-descriptor.json',
+};
+//# sourceMappingURL=constants.js.map

package/lib/interfaces/packagingInterfacesAndType.d.ts

@@ -1,4 +1,7 @@
 import { Duration } from '@salesforce/kit';
+import { Connection, SfProject } from '@salesforce/core';
+import { SaveResult } from 'jsforce';
+import { ProfileApi } from '../package/profileApi';
 import { PackagingSObjects } from './packagingSObjects';
 import Package2VersionStatus = PackagingSObjects.Package2VersionStatus;
 export interface IPackage {
@@ -54,3 +57,111 @@ export declare type Package2VersionCreateEventData = {
     message?: string;
     timeRemaining?: Duration;
 };
+export declare type PackageVersionListResult = {
+    Id: string;
+    Package2Id: string;
+    SubscriberPackageVersionId: string;
+    Name: string;
+    Package2: {
+        [key: string]: unknown;
+        Name: string;
+        NamespacePrefix: string;
+        IsOrgDependent?: boolean;
+    };
+    Description: string;
+    Tag: string;
+    Branch: string;
+    MajorVersion: string;
+    MinorVersion: string;
+    PatchVersion: string;
+    BuildNumber: string;
+    IsReleased: boolean;
+    CreatedDate: string;
+    LastModifiedDate: string;
+    IsPasswordProtected: boolean;
+    AncestorId: string;
+    ValidationSkipped: boolean;
+    CreatedById: string;
+    CodeCoverage?: {
+        [key: string]: unknown;
+        ApexCodeCoveragePercentage: number;
+    };
+    HasPassedCodeCoverageCheck?: boolean;
+    ConvertedFromVersionId?: string;
+    ReleaseVersion?: string;
+    BuildDurationInSeconds?: number;
+    HasMetadataRemoved?: boolean;
+};
+export declare type PackageType = 'Managed' | 'Unlocked';
+export declare type PackageCreateOptions = {
+    name: string;
+    description: string;
+    noNamespace: boolean;
+    orgDependent: boolean;
+    packageType: PackageType;
+    errorNotificationUsername: string;
+    path: string;
+};
+export declare type PackageVersionQueryOptions = {
+    project: SfProject;
+    orderBy: string;
+    modifiedLastDays: number;
+    createdLastDays: number;
+    packages: string[];
+    connection: Connection;
+    verbose: boolean;
+    concise: boolean;
+    isReleased: boolean;
+};
+export declare type PackageSaveResult = SaveResult;
+export declare type PackageVersionCreateRequestOptions = {
+    path: string;
+    preserve: boolean;
+    definitionfile?: string;
+    codecoverage?: boolean;
+    branch?: string;
+    skipancestorcheck?: boolean;
+};
+export declare type MDFolderForArtifactOptions = {
+    packageName?: string;
+    sourceDir?: string;
+    outputDir?: string;
+    manifest?: string;
+    sourcePaths?: string[];
+    metadataPaths?: string[];
+    deploydir?: string;
+};
+export declare type PackageVersionOptions = {
+    connection: Connection;
+    project: SfProject;
+};
+export declare type PackageVersionCreateOptions = PackageVersionOptions & {
+    branch: string;
+    buildinstance: string;
+    codecoverage: boolean;
+    definitionfile: string;
+    installationkey: string;
+    installationkeybypass: boolean;
+    package: string;
+    path: string;
+    postinstallscript: string;
+    postinstallurl: string;
+    preserve: boolean;
+    releasenotesurl: string;
+    skipancestorcheck: boolean;
+    skipvalidation: boolean;
+    sourceorg: string;
+    tag: string;
+    uninstallscript: string;
+    validateschema: boolean;
+    versiondescription: string;
+    versionname: string;
+    versionnumber: string;
+    wait: Duration;
+    profileApi?: ProfileApi;
+};
+export declare type PackageVersionCreateRequestQueryOptions = {
+    createdlastdays?: number;
+    connection?: Connection;
+    status?: string;
+};

package/lib/interfaces/packagingSObjects.d.ts

@@ -1,3 +1,4 @@
+import { PackageType } from './packagingInterfacesAndType';
 export declare namespace PackagingSObjects {
     type Package2 = {
         Id: string;
@@ -11,7 +12,7 @@ export declare namespace PackagingSObjects {
         Name: string;
         Description: string;
         NamespacePrefix: string;
-        ContainerOptions: string;
+        ContainerOptions: PackageType;
         IsDeprecated: boolean;
         IsOrgDependent: boolean;
         ConvertedFromPackageId: string;

package/lib/interfaces/packagingSObjects.js

@@ -1,12 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PackagingSObjects = 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
- */
 var PackagingSObjects;
 (function (PackagingSObjects) {
     let Package2VersionStatus;

package/lib/package/index.d.ts

@@ -1,3 +1,7 @@
 export * from './package';
 export * from './packageVersion2GP';
 export * from './packageList';
+export * from './packageVersionCreateRequest';
+export { listPackageVersions } from './packageVersionList';
+export { createPackage } from './packageCreate';
+export { deletePackage } from './packageDelete';

package/lib/package/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deletePackage = exports.createPackage = exports.listPackageVersions = void 0;
 /*
  * Copyright (c) 2022, salesforce.com, inc.
  * All rights reserved.
@@ -23,4 +24,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./package"), exports);
 __exportStar(require("./packageVersion2GP"), exports);
 __exportStar(require("./packageList"), exports);
+__exportStar(require("./packageVersionCreateRequest"), exports);
+var packageVersionList_1 = require("./packageVersionList");
+Object.defineProperty(exports, "listPackageVersions", { enumerable: true, get: function () { return packageVersionList_1.listPackageVersions; } });
+var packageCreate_1 = require("./packageCreate");
+Object.defineProperty(exports, "createPackage", { enumerable: true, get: function () { return packageCreate_1.createPackage; } });
+var packageDelete_1 = require("./packageDelete");
+Object.defineProperty(exports, "deletePackage", { enumerable: true, get: function () { return packageDelete_1.deletePackage; } });
 //# sourceMappingURL=index.js.map

package/lib/package/packageConvert.d.ts

@@ -0,0 +1,11 @@
+import { Connection, Org, SfProject } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+import { Package2VersionCreateRequestResult } from '../interfaces';
+declare type ConvertPackageOptions = {
+    installationKey: string;
+    installationKeyBypass: boolean;
+    wait: Duration;
+    buildInstance: string;
+};
+export declare function convertPackage(pkg: string, org: Org, connection: Connection, project: SfProject, options: ConvertPackageOptions): Promise<Package2VersionCreateRequestResult>;
+export {};

package/lib/package/packageConvert.js

@@ -0,0 +1,78 @@
+"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.convertPackage = void 0;
+const path = require("path");
+const util = require("util");
+const os = require("os");
+const fs = require("fs");
+const kit_1 = require("@salesforce/kit");
+const testSetup_1 = require("@salesforce/core/lib/testSetup");
+const pkgUtils = require("../utils/packageUtils");
+const constants_1 = require("../constants");
+const srcDevUtil = require("../utils/srcDevUtils");
+const packageVersionCreateRequest_1 = require("./packageVersionCreateRequest");
+async function convertPackage(pkg, org, connection, project, options) {
+    let maxRetries = 0;
+    const branch = 'main';
+    if (options.wait) {
+        maxRetries = (60 / pkgUtils.POLL_INTERVAL_SECONDS) * options.wait.seconds;
+    }
+    const packageId = await pkgUtils.findOrCreatePackage2(pkg, connection);
+    const request = await createPackageVersionCreateRequest(context, packageId);
+    const createResult = await connection.tooling.create('Package2VersionCreateRequest', request);
+    if (!createResult.success) {
+        const errStr = createResult.errors && createResult.errors.length ? createResult.errors.join(', ') : createResult.errors;
+        throw new Error(`Failed to create request${createResult.id ? ` [${createResult.id}]` : ''}: ${errStr}`);
+    }
+    let results;
+    if (options.wait) {
+        results = await pkgUtils.pollForStatusWithInterval(createResult.id, maxRetries, packageId, branch, project, connection, new kit_1.Duration(pkgUtils.POLL_INTERVAL_SECONDS, kit_1.Duration.Unit.SECONDS));
+    }
+    else {
+        results = await (0, packageVersionCreateRequest_1.byId)(packageId, connection);
+    }
+    return util.isArray(results) ? results[0] : results;
+}
+exports.convertPackage = convertPackage;
+/**
+ * Convert the list of command line options to a JSON object that can be used to create an Package2VersionCreateRequest entity.
+ *
+ * @param context: command context
+ * @param packageId: package2 id to create a package version for
+ * @returns {{Package2Id: string, Package2VersionMetadata: *, Tag: *, Branch: number}}
+ * @private
+ */
+async function createPackageVersionCreateRequest(context, packageId) {
+    const uniqueId = (0, testSetup_1.uniqid)({ template: `${packageId}-%s` });
+    const packageVersTmpRoot = path.join(os.tmpdir(), uniqueId);
+    const packageVersBlobDirectory = path.join(packageVersTmpRoot, 'package-version-info');
+    const packageVersBlobZipFile = path.join(packageVersTmpRoot, constants_1.consts.PACKAGE_VERSION_INFO_FILE_ZIP);
+    const packageDescriptorJson = {
+        id: packageId,
+    };
+    await fs.promises.mkdir(packageVersTmpRoot, { recursive: true });
+    await fs.promises.mkdir(packageVersBlobDirectory, { recursive: true });
+    await fs.promises.writeFile(path.join(packageVersBlobDirectory, constants_1.consts.PACKAGE2_DESCRIPTOR_FILE), JSON.stringify(packageDescriptorJson, undefined, 2));
+    // Zip the Version Info and package.zip files into another zip
+    await srcDevUtil.zipDir(packageVersBlobDirectory, packageVersBlobZipFile);
+    return createRequestObject(packageId, context, packageVersTmpRoot, packageVersBlobZipFile);
+}
+async function createRequestObject(packageId, options, packageVersTmpRoot, packageVersBlobZipFile) {
+    const zipFileBase64 = (await fs.promises.readFile(packageVersBlobZipFile)).toString('base64');
+    const requestObject = {
+        Package2Id: packageId,
+        VersionInfo: zipFileBase64,
+        InstallKey: options.installationkey,
+        Instance: options.buildinstance,
+        IsConversionRequest: true,
+    };
+    await fs.promises.unlink(packageVersTmpRoot);
+    return requestObject;
+}
+//# sourceMappingURL=packageConvert.js.map

package/lib/package/packageCreate.d.ts

@@ -0,0 +1,26 @@
+import { Connection, NamedPackageDir, PackageDir, SfProject } from '@salesforce/core';
+import { PackageCreateOptions, PackagingSObjects } from '../interfaces';
+declare type Package2Request = Pick<PackagingSObjects.Package2, 'Name' | 'Description' | 'NamespacePrefix' | 'ContainerOptions' | 'IsOrgDependent' | 'PackageErrorUsername'>;
+export declare function _createPackage2RequestFromContext(project: SfProject, options: PackageCreateOptions): Package2Request;
+/**
+ * Generate packageDirectory json entry for this package that can be written to sfdx-project.json
+ *
+ * @param project
+ * @param packageId the 0Ho id of the package to create the entry for
+ * @private
+ */
+export declare function _generatePackageDirEntry(project: SfProject, options: PackageCreateOptions): PackageDir[] | NamedPackageDir[];
+/**
+ * Generate package alias json entry for this package that can be written to sfdx-project.json
+ *
+ * @param context
+ * @param packageId the 0Ho id of the package to create the alias entry for
+ * @private
+ */
+export declare function _generatePackageAliasEntry(project: SfProject, options: PackageCreateOptions, packageId: string): {
+    [key: string]: string;
+};
+export declare function createPackage(connection: Connection, project: SfProject, options: PackageCreateOptions): Promise<{
+    Id: string;
+}>;
+export {};

package/lib/package/packageCreate.js

@@ -0,0 +1,115 @@
+"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.createPackage = exports._generatePackageAliasEntry = exports._generatePackageDirEntry = exports._createPackage2RequestFromContext = void 0;
+const core_1 = require("@salesforce/core");
+const ts_types_1 = require("@salesforce/ts-types");
+const pkgUtils = require("../utils/packageUtils");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/packaging', 'messages');
+function _createPackage2RequestFromContext(project, options) {
+    const namespace = options.noNamespace ? '' : project.getSfProjectJson().getContents().namespace || '';
+    return {
+        Name: options.name,
+        Description: options.description,
+        NamespacePrefix: namespace,
+        ContainerOptions: options.packageType,
+        IsOrgDependent: options.orgDependent,
+        PackageErrorUsername: options.errorNotificationUsername,
+    };
+}
+exports._createPackage2RequestFromContext = _createPackage2RequestFromContext;
+/**
+ * Generate packageDirectory json entry for this package that can be written to sfdx-project.json
+ *
+ * @param project
+ * @param packageId the 0Ho id of the package to create the entry for
+ * @private
+ */
+function _generatePackageDirEntry(project, options) {
+    var _a, _b;
+    let packageDirs = project.getPackageDirectories();
+    if (!packageDirs) {
+        packageDirs = [];
+    }
+    // add an entry if it doesn't exist
+    // or update an existing entry if it matches path but has no package or id attribute (W-5092620)
+    let packageDir = project.getPackage(options.name) ||
+        project
+            .getPackageDirectories()
+            // TODO: I don't understand where id is coming from, because it is not in sfdx-project.json schema
+            .find((pd) => pd.path === options.path && !pd.id && !pd.package);
+    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);
+        // 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);
+        }
+    }
+    else {
+        // add new entry
+        packageDir = pkgUtils.DEFAULT_PACKAGE_DIR;
+        packageDir.package = options.name;
+        // set as default if this is the only entry or no other entry is the default
+        packageDir.default = !pkgUtils.getConfigPackageDirectory(packageDirs, 'default', true);
+        packageDir.path = options.path;
+        packageDirs.push(packageDir);
+    }
+    return packageDirs;
+}
+exports._generatePackageDirEntry = _generatePackageDirEntry;
+/**
+ * Generate package alias json entry for this package that can be written to sfdx-project.json
+ *
+ * @param context
+ * @param packageId the 0Ho id of the package to create the alias entry for
+ * @private
+ */
+function _generatePackageAliasEntry(project, options, packageId) {
+    const packageAliases = project.getSfProjectJson().getContents().packageAliases || {};
+    const packageName = options.name;
+    packageAliases[packageName] = packageId;
+    return packageAliases;
+}
+exports._generatePackageAliasEntry = _generatePackageAliasEntry;
+async function createPackage(connection, project, options) {
+    // strip trailing slash from path param
+    options.path = options.path.replace(/\/$/, '');
+    const request = _createPackage2RequestFromContext(project, options);
+    let packageId = null;
+    const createResult = await connection.tooling
+        .sobject('Package2')
+        .create(request)
+        .catch((err) => {
+        const error = (0, ts_types_1.isString)(err) ? err : err.message;
+        throw core_1.SfError.wrap(error);
+    });
+    if (!createResult.success) {
+        throw pkgUtils.combineSaveErrors('Package2', 'create', createResult.errors);
+    }
+    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])) {
+        throw messages.createError('unableToFindPackageWithId', [packageId]);
+    }
+    const record = queryResult.records[0];
+    if (!process.env.SFDX_PROJECT_AUTOUPDATE_DISABLE_FOR_PACKAGE_CREATE) {
+        const packageDirectory = _generatePackageDirEntry(project, options);
+        const packageAliases = _generatePackageAliasEntry(project, options, record.Id);
+        const projectJson = project.getSfProjectJson();
+        projectJson.set('packageDirectories', packageDirectory);
+        projectJson.set('packageAliases', packageAliases);
+        await projectJson.write();
+    }
+    return { Id: record.Id };
+}
+exports.createPackage = createPackage;
+//# sourceMappingURL=packageCreate.js.map

package/lib/package/packageDelete.d.ts

@@ -0,0 +1,3 @@
+import { Connection, SfProject } from '@salesforce/core';
+import { PackageSaveResult } from '../interfaces';
+export declare function deletePackage(idOrAlias: string, project: SfProject, connection: Connection, undelete: boolean): Promise<PackageSaveResult>;

package/lib/package/packageDelete.js

@@ -0,0 +1,26 @@
+"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.deletePackage = void 0;
+const pkgUtils = require("../utils/packageUtils");
+const utils_1 = require("../utils");
+async function deletePackage(idOrAlias, project, connection, undelete) {
+    const packageId = pkgUtils.getPackageIdFromAlias(idOrAlias, project);
+    pkgUtils.validateId(pkgUtils.BY_LABEL.PACKAGE_ID, packageId);
+    const request = {};
+    request.Id = packageId;
+    const isUndelete = undelete;
+    request.IsDeprecated = !isUndelete;
+    const updateResult = await connection.tooling.update('Package2', request);
+    if (!updateResult.success) {
+        throw (0, utils_1.combineSaveErrors)('Package2', 'update', updateResult.errors);
+    }
+    return updateResult;
+}
+exports.deletePackage = deletePackage;
+//# sourceMappingURL=packageDelete.js.map

package/lib/package/packageVersion.d.ts

@@ -0,0 +1,8 @@
+import { Package2VersionCreateRequestResult, PackageVersionCreateOptions, PackageVersionOptions } from '../interfaces';
+export declare class PackageVersion {
+    private options;
+    private readonly project;
+    private readonly connection;
+    protected constructor(options: PackageVersionOptions);
+    createPackageVersion(options: PackageVersionCreateOptions): Promise<Partial<Package2VersionCreateRequestResult>>;
+}

package/lib/package/packageVersion.js

@@ -0,0 +1,27 @@
+"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.PackageVersion = void 0;
+const core_1 = require("@salesforce/core");
+const packageVersionCreate_1 = require("./packageVersionCreate");
+core_1.Messages.importMessagesDirectory(__dirname);
+// const messages = Messages.loadMessages('@salesforce/packaging', 'messages');
+// const logger = Logger.childFromRoot('packageVersionCreate');
+class PackageVersion {
+    constructor(options) {
+        this.options = options;
+        this.connection = this.options.connection;
+        this.project = this.options.project;
+    }
+    async createPackageVersion(options) {
+        const pvc = new packageVersionCreate_1.PackageVersionCreate(options);
+        return pvc.createPackageVersion(options);
+    }
+}
+exports.PackageVersion = PackageVersion;
+//# sourceMappingURL=packageVersion.js.map

package/lib/package/packageVersionCreate.d.ts

@@ -0,0 +1,70 @@
+import { Connection } from '@salesforce/core';
+import { Package2VersionCreateRequestResult, PackageVersionCreateOptions } from '../interfaces';
+export declare class PackageVersionCreate {
+    private options;
+    private apiVersionFromPackageXml;
+    private packageDirs;
+    private readonly project;
+    private readonly connection;
+    constructor(options: PackageVersionCreateOptions);
+    createPackageVersion(options: PackageVersionCreateOptions): Promise<Partial<Package2VersionCreateRequestResult>>;
+    listRequest(createdlastdays?: number, status?: string): Promise<Package2VersionCreateRequestResult[]>;
+    listRequestById(id: string, connection: Connection): Promise<Package2VersionCreateRequestResult[]>;
+    rejectWithInstallKeyError(): Promise<never>;
+    private generateMDFolderForArtifact;
+    private validateDependencyValues;
+    /**
+     *  A dependency in the workspace config file may be specified using either a subscriber package version id (04t)
+     *  or a package Id (0Ho) + a version number.  Additionally, a build number may be the actual build number, or a
+     *  keyword: LATEST or RELEASED (meaning the latest or released build number for a given major.minor.patch).
+     *
+     *  This method resolves a package Id + version number to a subscriber package version id (04t)
+     *  and adds it as a SubscriberPackageVersionId parameter in the dependency object.
+     */
+    private retrieveSubscriberPackageVersionId;
+    private resolveBuildNumber;
+    private createRequestObject;
+    private getPackageDescriptorJsonFromPackageId;
+    /**
+     * Convert the list of command line options to a JSON object that can be used to create an Package2VersionCreateRequest entity.
+     *
+     * @param options
+     * @param packageId
+     * @param versionNumberString
+     * @returns {{Package2Id: (*|p|boolean), Package2VersionMetadata: *, Tag: *, Branch: number}}
+     * @private
+     */
+    private createPackageVersionCreateRequestFromOptions;
+    private resolveApexTestPermissions;
+    private resolveUnpackagedMetadata;
+    private getPackagePropertyFromPackage;
+    private getPackageValuePropertyFromDirectory;
+    /**
+     * Returns the property value that corresponds to the propertyToLookup.  This value found for a particular
+     * package directory element that matches the knownProperty and knownValue.  In other words, we locate a package
+     * directory element whose knownProperty matches the knownValue, then we grab the value for the propertyToLookup
+     * and return it.
+     *
+     * @param packageDirs The list of all the package directories from the sfdx-project.json
+     * @param propertyToLookup The property ID whose value we want to find
+     * @param knownProperty The JSON property in the packageDirectories that is already known
+     * @param knownValue The value that corresponds to the knownProperty in the packageDirectories JSON
+     * @param knownFlag The flag details e.g. short/long name, etc. Only used for the error message
+     * @param options
+     */
+    private getConfigPackageDirectoriesValue;
+    private packageVersionCreate;
+    private resolveCanonicalPackageProperty;
+    private validateVersionNumber;
+    private resolveUserLicenses;
+    private resolveOrgDependentPollingTime;
+    private validateFlagsForPackageType;
+    /**
+     * Cleans invalid attribute(s) from the packageDescriptorJSON
+     */
+    private cleanPackageDescriptorJson;
+    /**
+     * Sets default or override values for packageDescriptorJSON attribs
+     */
+    private setPackageDescriptorJsonValues;
+}