@salesforce/packaging 0.0.4 → 0.0.7

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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.7](https://github.com/forcedotcom/packaging/compare/v0.0.6...v0.0.7) (2022-07-14)
+
+### Bug Fixes
+
+- add package version create/delete to library ([7713d4d](https://github.com/forcedotcom/packaging/commit/7713d4dc7d25f2a381a6972e57f24c9fbdcbae05))
+
+### [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)

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 { PackageProfileApi } from '../package/packageProfileApi';
 import { PackagingSObjects } from './packagingSObjects';
 import Package2VersionStatus = PackagingSObjects.Package2VersionStatus;
 export interface IPackage {
@@ -31,7 +34,7 @@ export interface IPackageVersion2GP {
 export declare type PackageOptions = Record<string, unknown>;
 export declare type PackageVersion2Options = Record<string, unknown>;
 export declare type PackageVersionOptions1GP = Record<string, unknown>;
-export declare type Package2VersionCreateRequestResult = {
+export declare type PackageVersionCreateRequestResult = {
     Id: string;
     Status: Package2VersionStatus;
     Package2Id: string;
@@ -44,13 +47,13 @@ export declare type Package2VersionCreateRequestResult = {
     HasMetadataRemoved: boolean | null;
     CreatedBy: string;
 };
-export declare type Package2VersionCreateRequestError = {
+export declare type PackageVersionCreateRequestError = {
     Message: string;
 };
-export declare type Package2VersionCreateEventData = {
+export declare type PackageVersionCreateEventData = {
     id: string;
     packageUpdated?: boolean;
-    package2VersionCreateRequestResult: Package2VersionCreateRequestResult;
+    packageVersionCreateRequestResult: PackageVersionCreateRequestResult;
     message?: string;
     timeRemaining?: Duration;
 };
@@ -89,3 +92,81 @@ export declare type PackageVersionListResult = {
     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 = Partial<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: PackageProfileApi;
+}>;
+export declare type PackageVersionCreateRequestQueryOptions = {
+    createdlastdays?: number;
+    connection?: Connection;
+    status?: string;
+};
+export declare type ProfileApiOptions = {
+    project: SfProject;
+    includeUserLicenses: boolean;
+    generateProfileInformation: boolean;
+};

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,4 +1,7 @@
 export * from './package';
-export * from './packageVersion2GP';
+export * from './packageVersion';
 export * from './packageList';
+export * from './packageVersionCreateRequest';
 export { listPackageVersions } from './packageVersionList';
+export { createPackage } from './packageCreate';
+export { deletePackage } from './packageDelete';

package/lib/package/index.js

@@ -14,7 +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.listPackageVersions = void 0;
+exports.deletePackage = exports.createPackage = exports.listPackageVersions = void 0;
 /*
  * Copyright (c) 2022, salesforce.com, inc.
  * All rights reserved.
@@ -22,8 +22,13 @@ exports.listPackageVersions = void 0;
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 __exportStar(require("./package"), exports);
-__exportStar(require("./packageVersion2GP"), exports);
+__exportStar(require("./packageVersion"), 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 { PackageVersionCreateRequestResult } 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<PackageVersionCreateRequestResult>;
+export {};

package/lib/package/packageConvert.js

@@ -0,0 +1,84 @@
+"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 core_1 = require("@salesforce/core");
+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");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/packaging', 'messages');
+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.findOrCreatePackage(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 messages.createError('failedToCreatePVCRequest', [
+            createResult.id ? ` [${createResult.id}]` : '',
+            errStr.toString(),
+        ]);
+    }
+    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 _createPackageRequestFromContext(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._createPackageRequestFromContext = 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 _createPackageRequestFromContext(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._createPackageRequestFromContext = _createPackageRequestFromContext;
+/**
+ * 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 = _createPackageRequestFromContext(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/packageProfileApi.d.ts

@@ -0,0 +1,59 @@
+import { ConfigAggregator, SfProject } from '@salesforce/core';
+import { AsyncCreatable } from '@salesforce/kit';
+import { ProfileApiOptions } from '../interfaces';
+export declare class PackageProfileApi extends AsyncCreatable<ProfileApiOptions> {
+    private options;
+    readonly profiles: ProfileInformation[];
+    apiVersion: string;
+    nodeEntities: {
+        name: string[];
+        childElement: string[];
+        parentElement: string[];
+    };
+    otherProfileSettings: {
+        name: string[];
+        childElement: string[];
+        parentElement: string[];
+    };
+    config: ConfigAggregator;
+    project: SfProject;
+    includeUserLicenses: boolean;
+    generateProfileInformation: boolean;
+    constructor(options: ProfileApiOptions);
+    init(): Promise<void>;
+    /**
+     * For any profile present in the workspace, this function generates a subset of data that only contains references
+     * to items in the manifest.
+     *
+     * @param destPath location of new profiles
+     * @param manifest
+     * @param excludedDirectories Directories to not include profiles from
+     */
+    generateProfiles(destPath: string, manifest: {
+        Package: {
+            types: string[];
+        };
+    }, excludedDirectories?: string[]): any[];
+    /**
+     * Filter out all profiles in the manifest and if any profiles exists in the workspace, add them to the manifest.
+     *
+     * @param typesArr array of objects { name[], members[] } that represent package types JSON.
+     * @param excludedDirectories Direcotires not to generate profiles for
+     */
+    filterAndGenerateProfilesForManifest(typesArr: any, excludedDirectories?: string[]): any;
+    getProfileInformation(): ProfileInformation[];
+    private copyNodes;
+    private findAllProfiles;
+}
+declare class ProfileInformation {
+    ProfileName: string;
+    ProfilePath: string;
+    IsPackaged: boolean;
+    settingsRemoved: string[];
+    constructor(ProfileName: string, ProfilePath: string, IsPackaged: boolean, settingsRemoved: string[]);
+    setIsPackaged(IsPackaged: boolean): void;
+    appendRemovedSetting(setting: string): void;
+    logDebug(): string;
+    logInfo(): string;
+}
+export {};