@simplysf/simply-package 1.11.0 → 2.2.0

package/lib/commands/simply/package/dependencies/manage.js

@@ -0,0 +1,191 @@
+/*
+ * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/* eslint-disable no-await-in-loop */
+import { select } from '@inquirer/prompts';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { buildVersionService } from '../../../../common/packageVersionService.js';
+import { buildProjectService } from '../../../../common/sfdxProjectService.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@simplysf/simply-package', 'simply.package.dependencies.manage');
+export default class PackageDependenciesManage extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static requiresProject = true;
+    static flags = {
+        ...SfCommand.baseFlags,
+        branch: Flags.string({
+            summary: messages.getMessage('flags.branch.summary'),
+            description: messages.getMessage('flags.branch.description'),
+            char: 'b',
+        }),
+        'update-to-released': Flags.boolean({
+            summary: messages.getMessage('flags.update-to-released.summary'),
+            description: messages.getMessage('flags.update-to-released.description'),
+            default: false,
+            exclusive: ['update-to-latest'],
+        }),
+        'update-to-latest': Flags.boolean({
+            summary: messages.getMessage('flags.update-to-latest.summary'),
+            description: messages.getMessage('flags.update-to-latest.description'),
+            default: false,
+            exclusive: ['update-to-released'],
+        }),
+        'api-version': Flags.orgApiVersion(),
+        'target-dev-hub': Flags.requiredHub(),
+    };
+    // eslint-disable-next-line complexity
+    async run() {
+        const { flags } = await this.parse(PackageDependenciesManage);
+        const isInteractive = !flags['update-to-released'] && !flags['update-to-latest'];
+        const connection = flags['target-dev-hub'].getConnection(flags['api-version']);
+        this.spinner.start(messages.getMessage('info.loadingDevHubData'));
+        const versionService = await buildVersionService(connection, this.project);
+        this.spinner.stop();
+        this.spinner.start(messages.getMessage('info.analyzingDependencies'));
+        const projectService = await buildProjectService(this.project);
+        const dependenciesByDirectory = projectService.getDependenciesByDirectory();
+        const dependenciesToIgnore = projectService.getDependenciesToIgnore();
+        const branchesWithReleased = projectService.getBranchesWithReleasedVersions();
+        this.spinner.stop();
+        const changesByDirectory = new Map();
+        const results = [];
+        for (const [dirPath, dependencies] of dependenciesByDirectory) {
+            changesByDirectory.set(dirPath, []);
+            const dirResults = { packageDirectory: dirPath, changes: [] };
+            for (const rawDependency of dependencies) {
+                const dependency = versionService.enrichDependency(rawDependency);
+                const package2Id = dependency.package2Id;
+                const dependencyDisplayName = buildDisplayName(dependency, projectService.findAlias.bind(projectService));
+                this.info('');
+                if (!package2Id ||
+                    (!versionService.knowsAboutPackage(package2Id) &&
+                        !versionService.knowsAboutVersion(dependency.subscriberPackageVersionId ?? ''))) {
+                    this.info(messages.getMessage('info.dependencyNotManagedByDevHub', [dependencyDisplayName]));
+                    const oldAlias = projectService.findAlias(dependency.subscriberPackageVersionId ?? dependency.package2Id ?? '') ??
+                        dependencyDisplayName;
+                    changesByDirectory.get(dirPath).push({
+                        oldAlias,
+                        oldDependency: dependency,
+                        newAlias: oldAlias,
+                        newSubscriberPackageVersionId: dependency.subscriberPackageVersionId,
+                        newPackage2Id: dependency.package2Id,
+                        newVersionNumber: dependency.versionNumber,
+                        isSameAsOld: true,
+                    });
+                    dirResults.changes.push({ oldAlias, newAlias: oldAlias, changed: false });
+                    continue;
+                }
+                this.info(messages.getMessage('info.reviewingDependency', [dependencyDisplayName]));
+                const oldAlias = versionService.getVersionAlias(dependency.subscriberPackageVersionId ?? '') ??
+                    projectService.findAlias(dependency.subscriberPackageVersionId ?? dependency.package2Id ?? '') ??
+                    dependencyDisplayName;
+                const isIgnored = dependenciesToIgnore.includes(package2Id) ||
+                    dependenciesToIgnore.includes(versionService.getPackageAlias(package2Id) ?? '');
+                let choices = [];
+                if (isIgnored) {
+                    choices =
+                        dependency.subscriberPackageVersionId &&
+                            versionService.knowsAboutVersion(dependency.subscriberPackageVersionId)
+                            ? [{ name: 'Current version specified', value: dependency.subscriberPackageVersionId, short: oldAlias }]
+                            : [];
+                }
+                else if (isInteractive) {
+                    choices = versionService.buildInteractiveChoices(dependency, flags.branch ?? '', branchesWithReleased);
+                }
+                else if (flags['update-to-released']) {
+                    choices = versionService.buildReleasedChoices(dependency, branchesWithReleased);
+                }
+                else {
+                    choices = versionService.buildLatestChoices(dependency);
+                }
+                this.info('');
+                if (choices.length === 0) {
+                    this.info(messages.getMessage('info.noAlternatesFound', [dependencyDisplayName]));
+                    dirResults.changes.push({ oldAlias, newAlias: oldAlias, changed: false });
+                    continue;
+                }
+                let selectedValue;
+                if (isInteractive && !isIgnored) {
+                    const packageDisplayName = versionService.getPackageAlias(package2Id) ?? package2Id;
+                    selectedValue = await this.promptForVersion(messages.getMessage('prompt.selectVersion', [packageDisplayName]), choices);
+                }
+                else {
+                    selectedValue = choices[0].value;
+                }
+                const change = buildChange(oldAlias, dependency, selectedValue, versionService.getVersionAlias.bind(versionService), versionService.getPackage2IdForVersion.bind(versionService));
+                changesByDirectory.get(dirPath).push(change);
+                if (isIgnored) {
+                    this.info(messages.getMessage('info.versionIgnored', [dependencyDisplayName]));
+                }
+                else {
+                    this.info(messages.getMessage('info.versionSelected', [dependencyDisplayName, change.newAlias]));
+                }
+                dirResults.changes.push({ oldAlias, newAlias: change.newAlias, changed: !change.isSameAsOld });
+                this.info('');
+                this.info('*'.repeat(88));
+                this.info('');
+            }
+            results.push(dirResults);
+        }
+        await projectService.applyChanges(changesByDirectory);
+        return results;
+    }
+    // eslint-disable-next-line class-methods-use-this
+    async promptForVersion(message, choices) {
+        return select({ message, choices, pageSize: 8 });
+    }
+}
+function buildDisplayName(dependency, findAlias) {
+    if (dependency.subscriberPackageVersionId) {
+        const alias = findAlias(dependency.subscriberPackageVersionId);
+        return alias ? `${alias} (${dependency.subscriberPackageVersionId})` : dependency.subscriberPackageVersionId;
+    }
+    if (dependency.package2Id && dependency.versionNumber) {
+        const alias = findAlias(dependency.package2Id);
+        const base = alias ? `${alias} (${dependency.package2Id})` : dependency.package2Id;
+        return `${base} version ${dependency.versionNumber}`;
+    }
+    return '<unknown dependency>';
+}
+function buildChange(oldAlias, oldDependency, selectedValue, getVersionAlias, getPackage2Id) {
+    // Pinned selection: value is a SubscriberPackageVersionId (04t)
+    if (selectedValue.startsWith('04t')) {
+        const newAlias = getVersionAlias(selectedValue) ?? selectedValue;
+        const newPackage2Id = getPackage2Id(selectedValue);
+        return {
+            oldAlias,
+            oldDependency,
+            newAlias,
+            newSubscriberPackageVersionId: selectedValue,
+            newPackage2Id,
+            isSameAsOld: selectedValue === oldDependency.subscriberPackageVersionId,
+        };
+    }
+    // Non-pinned selection: value is "package2Id|major.minor.patch.LATEST"
+    const [package2Id, versionNumber] = selectedValue.split('|');
+    const newAlias = (getVersionAlias(package2Id) ?? package2Id) + '@' + versionNumber;
+    return {
+        oldAlias,
+        oldDependency,
+        newAlias,
+        newPackage2Id: package2Id,
+        newVersionNumber: versionNumber,
+        isSameAsOld: package2Id === oldDependency.package2Id && versionNumber === oldDependency.versionNumber,
+    };
+}
+//# sourceMappingURL=manage.js.map

package/lib/commands/simply/package/dependencies/manage.js.map

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

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

@@ -1,8 +1,17 @@
 /*
- * 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
+ * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
 import { Messages, Logger } from '@salesforce/core';
@@ -48,9 +57,9 @@ export default class PackageVersionCleanup extends SfCommand {
             throw messages.createError('errors.matcherFormatMismatch');
         }
         const matcherSplit = matcher.split('.');
-        const majorMatcher = matcherSplit.at(0);
-        const minorMatcher = matcherSplit.at(1);
-        const patchMatcher = matcherSplit.at(2);
+        const majorMatcher = matcherSplit[0];
+        const minorMatcher = matcherSplit[1];
+        const patchMatcher = matcherSplit[2];
         log.info(`Major Matcher ${majorMatcher} Minor Matcher ${minorMatcher} Patch Matcher ${patchMatcher}`);
         const packageVersionListOptions = {
             concise: false,
@@ -103,10 +112,13 @@ export default class PackageVersionCleanup extends SfCommand {
     }
     displayDeletionResults(packageCleanupResults) {
         this.styledHeader('Package Version Cleanup Results');
-        this.table(packageCleanupResults, {
-            SubscriberPackageVersionId: { header: 'PACKAGE VERSION ID' },
-            Success: { header: 'SUCCESS' },
-            Error: { header: 'ERROR' },
+        this.table({
+            data: packageCleanupResults,
+            columns: [
+                { key: 'SubscriberPackageVersionId', name: 'PACKAGE VERSION ID' },
+                { key: 'Success', name: 'SUCCESS' },
+                { key: 'Error', name: 'ERROR' },
+            ],
         });
     }
 }

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

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

@@ -1,6 +1,5 @@
-import { PackageDir } from '@salesforce/schemas';
+import { NamedPackageDir } from '@salesforce/core';
 import { InstalledPackages, PackagingSObjects } from '@salesforce/packaging';
-import { BasePackageDirWithDependencies } from '../schemas/packageDirs.js';
 type PackageInstallRequest = PackagingSObjects.PackageInstallRequest;
 export declare const PACKAGE_PREFIX_PACKAGE2 = "0Ho";
 export declare const PACKAGE_PREFIX_PACKAGE2_VERSION = "05i";
@@ -12,5 +11,14 @@ export declare const isSubscriberPackageId: (inputToEvaluate: string) => boolean
 export declare const isSubscriberPackageVersionId: (inputToEvaluate: string) => boolean;
 export declare const isSubscriberPackageVersionInstalled: (installedPackages: InstalledPackages[], subscriberPackageVersionId: string) => boolean;
 export declare const reducePackageInstallRequestErrors: (request: PackageInstallRequest) => string;
-export declare const isDependenciesPackagingDirectory: (packageDir: PackageDir) => packageDir is BasePackageDirWithDependencies;
+export declare const isDependenciesPackagingDirectory: (packageDir: NamedPackageDir) => packageDir is NamedPackageDir & {
+    path: string;
+    default?: boolean | undefined;
+    dependencies?: {
+        [x: string]: unknown;
+        package: string;
+        versionNumber?: string | undefined;
+        branch?: string | undefined;
+    }[] | undefined;
+};
 export {};

package/lib/common/packageUtils.js

@@ -1,8 +1,17 @@
 /*
- * 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
+ * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 export const PACKAGE_PREFIX_PACKAGE2 = '0Ho';
 export const PACKAGE_PREFIX_PACKAGE2_VERSION = '05i';

package/lib/common/packageUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"packageUtils.js","sourceRoot":"","sources":["../../src/common/packageUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AACvD,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,eAAuB,EAAW,EAAE,CAC/D,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,eAAuB,EAAW,EAAE,CACtE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAExF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,eAAuB,EAAW,EAAE,CACxE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAE1F,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,eAAuB,EAAW,EAAE,CAC/E,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,yCAAyC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAElG,MAAM,CAAC,MAAM,mCAAmC,GAAG,CACjD,iBAAsC,EACtC,0BAAkC,EACzB,EAAE,CACX,iBAAiB,CAAC,IAAI,CACpB,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,EAAE,wBAAwB,EAAE,EAAE,KAAK,0BAA0B,CACpG,CAAC;AAEJ,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,OAA8B,EAAU,EAAE;IAC1F,IAAI,YAAY,GAAG,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACvC,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,GAAG,uBAAuB,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,YAAY,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAAsB,EACwB,EAAE,CAChD,cAAc,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC"}
+{"version":3,"file":"packageUtils.js","sourceRoot":"","sources":["../../src/common/packageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AACvD,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,eAAuB,EAAW,EAAE,CAC/D,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,eAAuB,EAAW,EAAE,CACtE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAExF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,eAAuB,EAAW,EAAE,CACxE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAE1F,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,eAAuB,EAAW,EAAE,CAC/E,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,yCAAyC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAElG,MAAM,CAAC,MAAM,mCAAmC,GAAG,CACjD,iBAAsC,EACtC,0BAAkC,EACzB,EAAE,CACX,iBAAiB,CAAC,IAAI,CACpB,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,EAAE,wBAAwB,EAAE,EAAE,KAAK,0BAA0B,CACpG,CAAC;AAEJ,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,OAA8B,EAAU,EAAE;IAC1F,IAAI,YAAY,GAAG,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACvC,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,GAAG,uBAAuB,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,YAAY,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAA2B,EACqC,EAAE,CAClE,cAAc,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC"}

package/lib/common/packageVersionService.d.ts

@@ -0,0 +1,22 @@
+import { Connection } from '@salesforce/core';
+import { SfProject } from '@salesforce/core';
+import { PackageVersionListResult } from '@salesforce/packaging';
+import { ParsedDependency } from '../schemas/manage/parsedDependency.js';
+export type VersionChoice = {
+    name: string;
+    value: string;
+    short: string;
+};
+export type PackageVersionService = {
+    knowsAboutVersion(subscriberPackageVersionId: string): boolean;
+    knowsAboutPackage(package2Id: string): boolean;
+    getPackage2IdForVersion(subscriberPackageVersionId: string): string | undefined;
+    getVersionAlias(subscriberPackageVersionId: string): string | undefined;
+    getPackageAlias(package2Id: string): string | undefined;
+    enrichDependency(dependency: ParsedDependency): ParsedDependency;
+    buildInteractiveChoices(dependency: ParsedDependency, branch: string, branchesWithReleased: string[]): VersionChoice[];
+    buildReleasedChoices(dependency: ParsedDependency, branchesWithReleased: string[]): VersionChoice[];
+    buildLatestChoices(dependency: ParsedDependency): VersionChoice[];
+    findVersionById(subscriberPackageVersionId: string): PackageVersionListResult | undefined;
+};
+export declare function buildVersionService(connection: Connection, project: SfProject): Promise<PackageVersionService>;

package/lib/common/packageVersionService.js

@@ -0,0 +1,279 @@
+/*
+ * Copyright (c) 2026, Clay Chipps; Copyright (c) 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Package } from '@salesforce/packaging';
+export async function buildVersionService(connection, project) {
+    const packages = await Package.list(connection);
+    const versions = await Package.listVersions(connection, project, {
+        concise: false,
+        createdLastDays: undefined,
+        modifiedLastDays: undefined,
+        orderBy: 'Package2Id, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber',
+        isReleased: undefined,
+        verbose: true,
+    });
+    const versionsBySubscriberId = new Map();
+    const packageAliasById = new Map();
+    const versionsByPackageAndBranch = new Map();
+    const releasedVersionsByPackageAndBranch = new Map();
+    for (const pkg of packages) {
+        packageAliasById.set(pkg.Id, computePackageAlias(pkg));
+    }
+    for (const version of versions) {
+        versionsBySubscriberId.set(version.SubscriberPackageVersionId, version);
+        sortVersionIntoMap(versionsByPackageAndBranch, version);
+        if (version.IsReleased) {
+            sortVersionIntoMap(releasedVersionsByPackageAndBranch, version);
+        }
+    }
+    function computePackageAlias(pkg) {
+        return (pkg.NamespacePrefix ? pkg.NamespacePrefix + '.' : '') + pkg.Name;
+    }
+    function computeVersionAlias(v, branch) {
+        const seg = `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}-${v.BuildNumber}` + (branch ? '-' + branch : '');
+        const pkgAlias = packageAliasById.get(v.Package2Id) ?? v.Package2Id;
+        return pkgAlias + '@' + seg;
+    }
+    function sortVersionIntoMap(map, v) {
+        const branch = v.Branch ?? '';
+        const major = parseInt(v.MajorVersion, 10);
+        const minor = parseInt(v.MinorVersion, 10);
+        const patch = parseInt(v.PatchVersion, 10);
+        const build = parseInt(v.BuildNumber, 10);
+        if (!map.has(v.Package2Id))
+            map.set(v.Package2Id, new Map());
+        const byBranch = map.get(v.Package2Id);
+        if (!byBranch.has(branch))
+            byBranch.set(branch, new Map());
+        const byMajor = byBranch.get(branch);
+        if (!byMajor.has(major))
+            byMajor.set(major, new Map());
+        const byMinor = byMajor.get(major);
+        if (!byMinor.has(minor))
+            byMinor.set(minor, new Map());
+        const byPatch = byMinor.get(minor);
+        if (!byPatch.has(patch))
+            byPatch.set(patch, new Map());
+        const byBuild = byPatch.get(patch);
+        if (!byBuild.has(build))
+            byBuild.set(build, v);
+    }
+    // Walks a version map block to the latest (highest-key) entry at any depth
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function findLatestFromBlock(block) {
+        const keys = [...block.keys()];
+        const maxKey = keys.reduce((max, k) => (k > max ? k : max), keys[0]);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const entry = block.get(maxKey);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        return entry instanceof Map ? findLatestFromBlock(entry) : entry;
+    }
+    let ChunkLevel;
+    (function (ChunkLevel) {
+        ChunkLevel[ChunkLevel["Major"] = 1] = "Major";
+        ChunkLevel[ChunkLevel["Minor"] = 2] = "Minor";
+        ChunkLevel[ChunkLevel["Patch"] = 3] = "Patch";
+    })(ChunkLevel || (ChunkLevel = {}));
+    function findBlock(map, package2Id, branch, dependency, level
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        const resolvedBranch = branch ?? '';
+        const byBranch = map.get(package2Id);
+        if (!byBranch?.has(resolvedBranch))
+            return undefined;
+        const byMajor = byBranch.get(resolvedBranch);
+        if (level === ChunkLevel.Major)
+            return byMajor;
+        const byMinor = byMajor?.get(dependency.majorVersion);
+        if (level === ChunkLevel.Minor || byMinor === undefined)
+            return byMinor;
+        return byMinor.get(dependency.minorVersion);
+    }
+    function makeVersionChoice(v, label, branch) {
+        const seg = `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}-${v.BuildNumber}` + (branch ? '-' + branch : '');
+        return {
+            name: `${label}: ${seg}`,
+            value: v.SubscriberPackageVersionId,
+            short: seg,
+        };
+    }
+    function makeLatestChoice(v, label) {
+        const seg = `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}.LATEST`;
+        return {
+            name: label,
+            value: `${v.Package2Id}|${seg}`,
+            short: seg,
+        };
+    }
+    function findLatestReleasedForBranch(package2Id, branch, dependency, seen) {
+        const block = findBlock(releasedVersionsByPackageAndBranch, package2Id, branch, dependency, ChunkLevel.Major);
+        if (!block)
+            return undefined;
+        const v = findLatestFromBlock(block);
+        if (seen.has(v.SubscriberPackageVersionId))
+            return undefined;
+        seen.add(v.SubscriberPackageVersionId);
+        const label = branch
+            ? `Latest released version on build branch - ${branch}`
+            : 'Latest released version on main build branch';
+        return makeVersionChoice(v, label, branch || undefined);
+    }
+    function findLatestForBranch(package2Id, branch, dependency, level, label, seen) {
+        const block = findBlock(versionsByPackageAndBranch, package2Id, branch, dependency, level);
+        if (!block)
+            return undefined;
+        const v = findLatestFromBlock(block);
+        if (seen.has(v.SubscriberPackageVersionId))
+            return undefined;
+        seen.add(v.SubscriberPackageVersionId);
+        return makeVersionChoice(v, label, branch || undefined);
+    }
+    return {
+        knowsAboutVersion(id) {
+            return versionsBySubscriberId.has(id);
+        },
+        knowsAboutPackage(package2Id) {
+            return packageAliasById.has(package2Id);
+        },
+        getPackage2IdForVersion(subscriberPackageVersionId) {
+            return versionsBySubscriberId.get(subscriberPackageVersionId)?.Package2Id;
+        },
+        getVersionAlias(subscriberPackageVersionId) {
+            const v = versionsBySubscriberId.get(subscriberPackageVersionId);
+            if (!v)
+                return undefined;
+            return computeVersionAlias(v, v.Branch || undefined);
+        },
+        getPackageAlias(package2Id) {
+            return packageAliasById.get(package2Id);
+        },
+        findVersionById(subscriberPackageVersionId) {
+            return versionsBySubscriberId.get(subscriberPackageVersionId);
+        },
+        enrichDependency(dependency) {
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+            if (dependency.package2Id || !dependency.subscriberPackageVersionId)
+                return dependency;
+            const v = versionsBySubscriberId.get(dependency.subscriberPackageVersionId);
+            if (!v)
+                return dependency;
+            const parts = `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}.${v.BuildNumber}`.split('.');
+            return {
+                ...dependency,
+                package2Id: v.Package2Id,
+                versionNumber: `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}.${v.BuildNumber}`,
+                majorVersion: parseInt(parts[0], 10),
+                minorVersion: parseInt(parts[1], 10),
+                patchVersion: parseInt(parts[2], 10),
+                buildVersion: parseInt(parts[3], 10),
+            };
+        },
+        // eslint-disable-next-line complexity
+        buildInteractiveChoices(dependency, branch, branchesWithReleased) {
+            const package2Id = dependency.package2Id;
+            const maj = dependency.majorVersion ?? '';
+            const min = dependency.minorVersion ?? '';
+            const pat = dependency.patchVersion ?? '';
+            const choices = [];
+            const releasedChoices = [];
+            const seen = new Set();
+            // Latest released on null/main branch and named release branches
+            const releasedMain = findLatestReleasedForBranch(package2Id, '', dependency, seen);
+            if (releasedMain)
+                releasedChoices.push(releasedMain);
+            for (const b of branchesWithReleased ?? []) {
+                const rc = findLatestReleasedForBranch(package2Id, b, dependency, seen);
+                if (rc)
+                    releasedChoices.push(rc);
+            }
+            // Latest version on the specified feature branch
+            if (branch) {
+                const c = findLatestForBranch(package2Id, branch, dependency, ChunkLevel.Patch, `Latest version on '${branch}' branch`, seen);
+                if (c)
+                    choices.push(c);
+            }
+            // Latest build with same Major.Minor.Patch on main branch and release branches
+            const patchMain = findLatestForBranch(package2Id, '', dependency, ChunkLevel.Patch, `Latest ${maj}.${min}.${pat} version on main build branch`, seen);
+            if (patchMain)
+                choices.push(patchMain);
+            for (const b of branchesWithReleased ?? []) {
+                const c = findLatestForBranch(package2Id, b, dependency, ChunkLevel.Patch, `Latest ${maj}.${min}.${pat} version on build branch - ${b}`, seen);
+                if (c)
+                    choices.push(c);
+            }
+            // Latest build with same Major.Minor on main branch and release branches
+            const minorMain = findLatestForBranch(package2Id, '', dependency, ChunkLevel.Minor, `Latest ${maj}.${min} version on main build branch`, seen);
+            if (minorMain)
+                choices.push(minorMain);
+            for (const b of branchesWithReleased ?? []) {
+                const c = findLatestForBranch(package2Id, b, dependency, ChunkLevel.Minor, `Latest ${maj}.${min} version on build branch - ${b}`, seen);
+                if (c)
+                    choices.push(c);
+            }
+            // Latest build overall on main branch and release branches
+            const majorMain = findLatestForBranch(package2Id, '', dependency, ChunkLevel.Major, 'Latest version on main build branch', seen);
+            if (majorMain)
+                choices.push(majorMain);
+            for (const b of branchesWithReleased ?? []) {
+                const c = findLatestForBranch(package2Id, b, dependency, ChunkLevel.Major, `Latest version on build branch - ${b}`, seen);
+                if (c)
+                    choices.push(c);
+            }
+            // Released choices go after so they appear clearly
+            choices.push(...releasedChoices);
+            // Non-pinned latest for current Major.Minor.Patch
+            const block = findBlock(versionsByPackageAndBranch, package2Id, branch, dependency, ChunkLevel.Patch) ??
+                findBlock(versionsByPackageAndBranch, package2Id, '', dependency, ChunkLevel.Patch) ??
+                findBlock(versionsByPackageAndBranch, package2Id, '', dependency, ChunkLevel.Minor);
+            if (block) {
+                const v = findLatestFromBlock(block);
+                choices.push(makeLatestChoice(v, `Non-pinned latest ${maj}.${min}.${pat} build`));
+            }
+            // Keep the current version as last option
+            if (dependency.subscriberPackageVersionId && versionsBySubscriberId.has(dependency.subscriberPackageVersionId)) {
+                const v = versionsBySubscriberId.get(dependency.subscriberPackageVersionId);
+                choices.push(makeVersionChoice(v, 'Current version specified', v.Branch || undefined));
+            }
+            return choices;
+        },
+        buildReleasedChoices(dependency, branchesWithReleased) {
+            const package2Id = dependency.package2Id;
+            const choices = [];
+            const seen = new Set();
+            const main = findLatestReleasedForBranch(package2Id, '', dependency, seen);
+            if (main)
+                choices.push(main);
+            for (const b of branchesWithReleased ?? []) {
+                const c = findLatestReleasedForBranch(package2Id, b, dependency, seen);
+                if (c)
+                    choices.push(c);
+            }
+            return choices;
+        },
+        buildLatestChoices(dependency) {
+            const package2Id = dependency.package2Id;
+            const block = findBlock(versionsByPackageAndBranch, package2Id, '', dependency, ChunkLevel.Patch) ??
+                findBlock(versionsByPackageAndBranch, package2Id, '', dependency, ChunkLevel.Minor);
+            if (!block)
+                return [];
+            const v = findLatestFromBlock(block);
+            const maj = dependency.majorVersion ?? '';
+            const min = dependency.minorVersion ?? '';
+            const pat = dependency.patchVersion ?? '';
+            return [makeLatestChoice(v, `Non-pinned latest ${maj}.${min}.${pat} build`)];
+        },
+    };
+}
+//# sourceMappingURL=packageVersionService.js.map