@simplysf/simply-package 1.0.0

package/lib/commands/simply/package/version/cleanup.js

@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2024, Clay Chipps; Copyright (c) 2024, 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
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, Logger } from '@salesforce/core';
+import { Package, PackageVersion, } from '@salesforce/packaging';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@simplysf/simply-package', 'simply.package.version.cleanup');
+export default class PackageVersionCleanup extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    // This is annoying, but the underlying Salesforce Packaging API expects you to be in a project context
+    // https://github.com/forcedotcom/packaging/blob/49e2f0b76a8d206369bf99906d02f6c54d89247d/src/package/package.ts#L144
+    static requiresProject = true;
+    static flags = {
+        'api-version': Flags.orgApiVersion(),
+        matcher: Flags.string({
+            summary: messages.getMessage('flags.matcher.summary'),
+            description: messages.getMessage('flags.matcher.description'),
+            char: 's',
+            required: true,
+        }),
+        package: Flags.string({
+            summary: messages.getMessage('flags.package.summary'),
+            description: messages.getMessage('flags.package.description'),
+            char: 'p',
+            required: true,
+        }),
+        'target-dev-hub': Flags.requiredHub(),
+    };
+    async run() {
+        const log = await Logger.child(this.ctor.name);
+        const { flags } = await this.parse(PackageVersionCleanup);
+        // Create a connection to the org
+        const connection = flags['target-dev-hub']?.getConnection(flags['api-version']);
+        if (!connection) {
+            throw messages.createError('errors.connectionFailed');
+        }
+        const project = this.project;
+        const matcher = flags.matcher;
+        const matcherRegex = new RegExp(/^\d+\.\d+\.\d+$/);
+        const matcherValid = matcherRegex.test(matcher);
+        if (!matcherValid) {
+            throw messages.createError('errors.matcherFormatMismatch');
+        }
+        const matcherSplit = matcher.split('.');
+        const majorMatcher = matcherSplit.at(0);
+        const minorMatcher = matcherSplit.at(1);
+        const patchMatcher = matcherSplit.at(2);
+        log.info(`Major Matcher ${majorMatcher} Minor Matcher ${minorMatcher} Patch Matcher ${patchMatcher}`);
+        const packageVersionListOptions = {
+            concise: false,
+            createdLastDays: undefined,
+            modifiedLastDays: undefined,
+            orderBy: 'MajorVersion, MinorVersion, PatchVersion, BuildNumber',
+            packages: [flags.package],
+            isReleased: false,
+            verbose: true,
+        };
+        this.spinner.start('Analyzing which package versions to delete...');
+        const packageVersions = await Package.listVersions(connection, project, packageVersionListOptions);
+        const targetVersions = packageVersions.filter((packageVersion) => packageVersion.IsReleased === false &&
+            packageVersion.MajorVersion.toString() === majorMatcher &&
+            packageVersion.MinorVersion.toString() === minorMatcher &&
+            packageVersion.PatchVersion.toString() === patchMatcher);
+        const packageVersionDeletePromiseRequests = [];
+        targetVersions.forEach((targetVersion) => {
+            const packageVersionOptions = {
+                connection,
+                project,
+                idOrAlias: targetVersion.SubscriberPackageVersionId,
+            };
+            packageVersionDeletePromiseRequests.push(new PackageVersion(packageVersionOptions).delete());
+        });
+        const results = [];
+        this.spinner.stop();
+        this.spinner.start('Deleting the package versions...');
+        const promiseResults = await Promise.allSettled(packageVersionDeletePromiseRequests);
+        promiseResults.forEach((promiseResult, index) => {
+            switch (promiseResult.status) {
+                case 'fulfilled':
+                    results.push({
+                        Success: promiseResult?.value?.success,
+                        SubscriberPackageVersionId: targetVersions[index].SubscriberPackageVersionId,
+                    });
+                    break;
+                case 'rejected':
+                    results.push({
+                        Success: false,
+                        Error: promiseResult.reason,
+                        SubscriberPackageVersionId: targetVersions[index].SubscriberPackageVersionId,
+                    });
+                    break;
+            }
+        });
+        this.spinner.stop();
+        this.displayDeletionResults(results);
+        return results;
+    }
+    displayDeletionResults(packageCleanupResults) {
+        this.styledHeader('Package Version Cleanup Results');
+        this.table(packageCleanupResults, {
+            SubscriberPackageVersionId: { header: 'PACKAGE VERSION ID' },
+            Success: { header: 'SUCCESS' },
+            Error: { header: 'ERROR' },
+        });
+    }
+}
+//# sourceMappingURL=cleanup.js.map

package/lib/commands/simply/package/version/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../../../src/commands/simply/package/version/cleanup.ts"],"names":[],"mappings":"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"}

package/lib/common/packageUtils.d.ts

@@ -0,0 +1,11 @@
+import { Connection } from '@salesforce/core';
+import { InstalledPackages, PackagingSObjects } from '@salesforce/packaging';
+type PackageInstallRequest = PackagingSObjects.PackageInstallRequest;
+export declare const PACKAGE_ID_PREFIX = "0Ho";
+export declare const PACKAGE_VERSION_ID_PREFIX = "04t";
+export declare const isPackageId: (inputToEvaluate: string) => boolean;
+export declare const isPackageVersionId: (inputToEvaluate: string) => boolean;
+export declare const isPackageVersionInstalled: (installedPackages: InstalledPackages[], subscriberPackageVersionId: string) => boolean;
+export declare const reducePackageInstallRequestErrors: (request: PackageInstallRequest) => string;
+export declare const resolvePackageVersionId: (packageId: string, versionNumber: string, branch: string, connection: Connection) => Promise<string>;
+export {};

package/lib/common/packageUtils.js

@@ -0,0 +1,71 @@
+/*
+ * Copyright (c) 2024, Clay Chipps; Copyright (c) 2024, 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
+ */
+import { SfError } from '@salesforce/core';
+export const PACKAGE_ID_PREFIX = '0Ho';
+export const PACKAGE_VERSION_ID_PREFIX = '04t';
+export const isPackageId = (inputToEvaluate) => inputToEvaluate ? inputToEvaluate.startsWith(PACKAGE_ID_PREFIX) : false;
+export const isPackageVersionId = (inputToEvaluate) => inputToEvaluate ? inputToEvaluate.startsWith(PACKAGE_VERSION_ID_PREFIX) : false;
+export const isPackageVersionInstalled = (installedPackages, subscriberPackageVersionId) => {
+    const matchedPackaged = installedPackages.find((installedPackage) => installedPackage?.SubscriberPackageVersion?.Id === subscriberPackageVersionId);
+    return matchedPackaged ? true : false;
+};
+export const reducePackageInstallRequestErrors = (request) => {
+    let errorMessage = '<empty>';
+    const errors = request?.Errors?.errors;
+    if (errors?.length) {
+        errorMessage = 'Installation errors: ';
+        for (let i = 0; i < errors.length; i++) {
+            errorMessage += `\n${i + 1}) ${errors[i].message}`;
+        }
+    }
+    return errorMessage;
+};
+export const resolvePackageVersionId = async (packageId, versionNumber, branch, connection) => {
+    if (isPackageVersionId(packageId)) {
+        return packageId;
+    }
+    if (!isPackageId(packageId)) {
+        throw new SfError('The Package2Id provided is not a valid Package2Id');
+    }
+    // Strip out the "-LATEST" string as it won't be needed in the query.
+    const versionWorking = versionNumber.toUpperCase().replace('-LATEST', '').replace('.LATEST', '');
+    // Split the remaining "Major.Minor.Patch.BuildNumber" version number out to its individual integers.
+    const versionParts = versionWorking.split('.');
+    // Assemble the query needed
+    let query = 'SELECT SubscriberPackageVersionId, IsPasswordProtected, IsReleased ';
+    query += 'FROM Package2Version ';
+    query += `WHERE Package2Id='${packageId}' AND MajorVersion=${versionParts[0]} AND IsDeprecated = FALSE `;
+    // If Minor Version isn't set to LATEST, look for the exact Minor Version
+    if (versionParts[1]) {
+        query += `AND MinorVersion=${versionParts[1]} `;
+    }
+    // If Patch Version isn't set to LATEST, look for the exact Patch Version
+    if (versionParts[2]) {
+        query += `AND PatchVersion=${versionParts[2]} `;
+    }
+    // If Build Number isn't set to LATEST, look for the exact Package Version
+    if (versionParts[3]) {
+        query += `AND BuildNumber=${versionParts[3]} `;
+    }
+    // If Branch is specified, use it to filter
+    if (branch) {
+        query += `AND Branch='${branch.trim()}' `;
+    }
+    else {
+        query += 'AND Branch=NULL ';
+    }
+    // if the query is looking for a "LATEST", "Non-pinned" version, then we need
+    //  to sort the result list in such a manner to that the latest version will
+    //  be the first record in the result set.
+    query += 'ORDER BY MajorVersion DESC, MinorVersion DESC, PatchVersion DESC, BuildNumber DESC LIMIT 1';
+    const resultPackageVersionRecord = await connection.tooling.query(query);
+    if (resultPackageVersionRecord?.records?.length === 0) {
+        throw new SfError(`Unable to find SubscriberPackageVersionId for dependent package ${packageId}`);
+    }
+    return resultPackageVersionRecord.records[0]['SubscriberPackageVersionId'];
+};
+//# sourceMappingURL=packageUtils.js.map

package/lib/common/packageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageUtils.js","sourceRoot":"","sources":["../../src/common/packageUtils.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/lib/index.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2024, Clay Chipps; Copyright (c) 2024, 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
+ */
+export default {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe,EAAE,CAAC"}

package/messages/simply.package.dependencies.install.md

@@ -0,0 +1,151 @@
+# summary
+
+Install package dependencies for a Salesforce project.
+
+# description
+
+Installs all specified package dependencies in a Salesforce DX project using the sfdx-project.json definition.
+
+# flags.branch.summary
+
+Package branch to consider when specifiying a Package/VersionNumber combination
+
+# flags.branch.description
+
+For dependencies specified by Package/VersionNumber combination, you can specify the branch group of builds to work from by entering the branch build name. If not specified, the builds from NULL branch will be considered.
+
+# flags.apex-compile.summary
+
+Compile all Apex in the org and package, or only Apex in the package; unlocked packages only.
+
+# flags.apex-compile.description
+
+Applies to unlocked packages only. Specifies whether to compile all Apex in the org and package, or only the Apex in the package.
+
+For package installs into production orgs, or any org that has Apex Compile on Deploy enabled, the platform compiles all Apex in the org after the package install or upgrade operation completes.
+
+This approach assures that package installs and upgrades don’t impact the performance of an org, and is done even if --apex-compile package is specified.
+
+# flags.install-type.summary
+
+Install all packages or only deltas.
+
+# flags.install-type.description
+
+If 'All' is specified, then all packages specified in package dependencies are installed, regardless of if the version already is installed in the org. If 'Delta' is specified, then only packages that differ from what is installed in the org will be installed.
+
+# flags.installation-key.summary
+
+Installation key for key-protected packages
+
+# flags.installation-key.description
+
+Installation key for key-protected packages in the key:value format of SubscriberPackageVersionId:Key
+
+# flags.no-prompt.summary
+
+Don't prompt for confirmation.
+
+# flags.no-prompt.description
+
+Allows the following without an explicit confirmation response: 1) Remote Site Settings and Content Security Policy websites to send or receive data, and 2) --upgrade-type Delete to proceed.
+
+# flags.publish-wait.summary
+
+Maximum number of minutes to wait for the Subscriber Package Version ID to become available in the target org before canceling the install request.
+
+# flags.security-type.summary
+
+Security access type for the installed package. (deprecation notice: The default --security-type value will change from AllUsers to AdminsOnly in v47.0 or later.)
+
+# flags.skip-handlers.summary
+
+Skip install handlers (available handlers: FeatureEnforcement).
+
+# flags.skip-handlers.description
+
+Allows the installer of a package to optionally skip install handlers in order to decrease overall installation time (available handlers: FeatureEnforcement).
+
+# flags.target-dev-hub.summary
+
+Username or alias of the Dev Hub org.
+
+# flags.upgrade-type.summary
+
+Upgrade type for the package installation; available only for unlocked packages.
+
+# flags.upgrade-type.description
+
+For package upgrades, specifies whether to mark all removed components as deprecated (DeprecateOnly), to delete removed components that can be safely deleted and deprecate the others (Mixed), or to delete all removed components, except for custom objects and custom fields, that don't have dependencies (Delete). The default is Mixed. Can specify DeprecateOnly or Delete only for unlocked package upgrades.
+
+# flags.wait.summary
+
+Number of minutes to wait for installation status.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --target-org myTargetOrg --target-dev-hub myTargetDevHub
+
+- <%= config.bin %> <%= command.id %> --target-org myTargetOrg --target-dev-hub myTargetDevHub --installation-key "MyPackage1Alias:MyPackage1Key"
+
+- <%= config.bin %> <%= command.id %> --target-org myTargetOrg --target-dev-hub myTargetDevHub --installation-key "MyPackage1Alias:MyPackage1Key" --installation-key "MyPackage2Alias:MyPackage2Key"
+
+# error.apiVersionTooLow
+
+This command is supported only on API versions 36.0 and higher.
+
+# error.installationKeyFormat
+
+Installation Key should have the key:value format of SubscriberPackageVersionId:Key.
+
+You can use an alias in place of the SubscriberPackageVersionId.
+
+# error.invalidPackage2Id
+
+Unable to determine a valid Package2Id for %s.
+
+# error.invalidSubscriberPackageVersionId
+
+Unable to determine a valid SubscriberPackageVersionId for %s.
+
+# error.packageInstall
+
+Encountered errors installing the package! %s
+
+# error.packageInstallInProgress
+
+The package install is still In-Progress, so subsuequent dependencies cannot be installed yet. You can query the status using %s package install report -i %s -o %s.
+
+# error.packageInstallPollingTimeout
+
+Polling timeout exceeded
+
+# error.targetDevHubConnectionFailed
+
+Unable to establish connection to the org.
+
+# error.targetDevHubMissing
+
+This command requires a DevHub to be specified if providing a Package2Id and VersionNumber instead of a SubscriberPackageVersionId.
+
+# error.targetOrgConnectionFailed
+
+Unable to establish connection to the org.
+
+# info.canceledPackageInstall
+
+We canceled this package installation per your request.
+
+# prompt.enableRss
+
+This package might send or receive data from these third-party websites:
+
+[%s]
+
+Grant access (y/n)?
+
+# prompt.upgradeType
+
+The Delete upgrade type permanently deletes metadata types that have been removed from the package. Deleted metadata can’t be recovered. We don't delete custom objects and custom fields. Instead, we deprecate them.
+
+Do you want to continue? (y/n)

package/messages/simply.package.version.cleanup.md

@@ -0,0 +1,39 @@
+# summary
+
+Cleanup package versions.
+
+# description
+
+Delete package versions for a given package provided a MAJOR.MINOR.PATCH matcher. Does not delete released pacakge versions.
+
+# flags.package.summary
+
+Package Id
+
+# flags.package.description
+
+The 0Ht Package Id that you wish to cleanup versions for.
+
+# flags.matcher.summary
+
+MAJOR.MINOR.PATCH
+
+# flags.matcher.description
+
+The MAJOR.MINOR.PATCH matcher that should be used to find package versions to delete.
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --package 0Hoxx00000000CqCAI --matcher 2.10.0 --target-dev-hub myDevHub
+
+# errors.connectionFailed
+
+Unable to establish connection to the org.
+
+# errors.matcherFormatMismatch
+
+The matcher must be in the format of MAJOR.MINOR.PATCH.
+
+# errors.deletionJob
+
+There was an unexpected error performing the deletion job.