@simplysf/simply-package 2.1.0 → 2.3.0

package/README.md

@@ -57,6 +57,7 @@ sf plugins
 
 <!-- commands -->
 * [`sf simply package dependencies install`](#sf-simply-package-dependencies-install)
+* [`sf simply package dependencies manage`](#sf-simply-package-dependencies-manage)
 * [`sf simply package version cleanup`](#sf-simply-package-version-cleanup)
 
 ## `sf simply package dependencies install`
@@ -153,7 +154,66 @@ FLAG DESCRIPTIONS
     from by entering the branch build name. If not specified, the builds from NULL branch will be considered.
 ```
 
-_See code: [lib/commands/simply/package/dependencies/install.js](https://github.com/SimplySF/simply-package/blob/1.12.0/lib/commands/simply/package/dependencies/install.js)_
+_See code: [lib/commands/simply/package/dependencies/install.js](https://github.com/SimplySF/simply-package/blob/2.3.0/lib/commands/simply/package/dependencies/install.js)_
+
+## `sf simply package dependencies manage`
+
+Manage package dependency versions for a Salesforce project.
+
+```
+USAGE
+  $ sf simply package dependencies manage -v <value> [--json] [--flags-dir <value>] [-b <value>] [--update-to-released |
+    --update-to-latest] [--api-version <value>]
+
+FLAGS
+  -b, --branch=<value>          Package branch to consider when evaluating version options.
+  -v, --target-dev-hub=<value>  (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
+                                configuration variable is already set.
+      --api-version=<value>     Override the api version used for api requests made by this command
+      --update-to-latest        Automatically set all dependencies to the latest non-pinned build.
+      --update-to-released      Automatically update all dependencies to the latest released version.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Manage package dependency versions for a Salesforce project.
+
+  Interactively updates package dependency versions in sfdx-project.json by querying the Dev Hub for available versions.
+  Supports interactive selection or automatic update to the latest released or latest build version.
+
+  Project-level configuration (in sfdx-project.json) is read from the following keys:
+
+  - plugins.simply.dependencies.ignore — array of Package2Ids or aliases to leave unchanged
+  - plugins.simply.package.brancheswithreleasedversions — array of branch names that contain released versions
+
+EXAMPLES
+  $ sf simply package dependencies manage --target-dev-hub myDevHub
+
+  $ sf simply package dependencies manage --target-dev-hub myDevHub --branch my-feature-branch
+
+  $ sf simply package dependencies manage --target-dev-hub myDevHub --update-to-released
+
+  $ sf simply package dependencies manage --target-dev-hub myDevHub --update-to-latest
+
+FLAG DESCRIPTIONS
+  -b, --branch=<value>  Package branch to consider when evaluating version options.
+
+    When specified, the command will include the latest build on this branch as a selectable option for each dependency.
+
+  --update-to-latest  Automatically set all dependencies to the latest non-pinned build.
+
+    When specified, all dependencies managed by the Dev Hub are automatically set to a non-pinned X.Y.Z.LATEST version
+    number without interactive prompts. Mutually exclusive with --update-to-released.
+
+  --update-to-released  Automatically update all dependencies to the latest released version.
+
+    When specified, all dependencies managed by the Dev Hub are automatically updated to the latest released package
+    version without interactive prompts. Mutually exclusive with --update-to-latest.
+```
+
+_See code: [lib/commands/simply/package/dependencies/manage.js](https://github.com/SimplySF/simply-package/blob/2.3.0/lib/commands/simply/package/dependencies/manage.js)_
 
 ## `sf simply package version cleanup`
 
@@ -194,5 +254,5 @@ FLAG DESCRIPTIONS
     The MAJOR.MINOR.PATCH matcher that should be used to find package versions to delete.
 ```
 
-_See code: [lib/commands/simply/package/version/cleanup.js](https://github.com/SimplySF/simply-package/blob/1.12.0/lib/commands/simply/package/version/cleanup.js)_
+_See code: [lib/commands/simply/package/version/cleanup.js](https://github.com/SimplySF/simply-package/blob/2.3.0/lib/commands/simply/package/version/cleanup.js)_
 <!-- commandsstop -->

package/lib/commands/simply/package/dependencies/manage.d.ts

@@ -0,0 +1,20 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { PackageDependenciesManageResult } from '../../../../schemas/manage/dependencyChange.js';
+import { VersionChoice } from '../../../../common/packageVersionService.js';
+export type { PackageDependenciesManageResult };
+export default class PackageDependenciesManage extends SfCommand<PackageDependenciesManageResult[]> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly requiresProject = true;
+    static readonly flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'update-to-released': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'update-to-latest': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-dev-hub': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PackageDependenciesManageResult[]>;
+    protected promptForVersion(message: string, choices: VersionChoice[]): Promise<string>;
+}

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

@@ -0,0 +1,196 @@
+/*
+ * 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.analyzingDependencies'));
+        const projectService = await buildProjectService(this.project);
+        const dependenciesByDirectory = projectService.getDependenciesByDirectory();
+        const dependenciesToIgnore = projectService.getDependenciesToIgnore();
+        const branchesWithReleased = projectService.getBranchesWithReleasedVersions();
+        this.spinner.stop();
+        const allDependencies = [...dependenciesByDirectory.values()].flat();
+        const filterIds = {
+            package2Ids: allDependencies.flatMap((d) => (d.package2Id ? [d.package2Id] : [])),
+            subscriberVersionIds: allDependencies.flatMap((d) => d.subscriberPackageVersionId ? [d.subscriberPackageVersionId] : []),
+        };
+        this.spinner.start(messages.getMessage('info.loadingDevHubData'));
+        const versionService = await buildVersionService(connection, this.project, filterIds);
+        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/common/packageVersionService.d.ts

@@ -0,0 +1,26 @@
+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 type VersionServiceFilterIds = {
+    package2Ids: string[];
+    subscriberVersionIds: string[];
+};
+export declare function buildVersionService(connection: Connection, project: SfProject, filterIds?: VersionServiceFilterIds): Promise<PackageVersionService>;

package/lib/common/packageVersionService.js

@@ -0,0 +1,314 @@
+/*
+ * 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, Package2Fields } from '@salesforce/packaging';
+export async function buildVersionService(connection, project, filterIds) {
+    let packages;
+    let versions;
+    if (filterIds) {
+        const package2IdSet = new Set(filterIds.package2Ids);
+        if (filterIds.subscriberVersionIds.length > 0) {
+            const inClause = filterIds.subscriberVersionIds.map((id) => `'${id}'`).join(', ');
+            const result = await connection.autoFetchQuery(`SELECT Package2Id FROM Package2Version WHERE SubscriberPackageVersionId IN (${inClause})`, { tooling: true });
+            for (const rec of result.records) {
+                package2IdSet.add(rec.Package2Id);
+            }
+        }
+        const targetPackage2Ids = [...package2IdSet];
+        if (targetPackage2Ids.length === 0) {
+            packages = [];
+            versions = [];
+        }
+        else {
+            const apiVersion = connection.getApiVersion();
+            const fields = Package2Fields.filter((f) => apiVersion >= '59.0' || f !== 'AppAnalyticsEnabled').filter((f) => apiVersion >= '66.0' || f !== 'RecommendedVersionId');
+            const inClause = targetPackage2Ids.map((id) => `'${id}'`).join(', ');
+            const pkg2Result = await connection.autoFetchQuery(`SELECT ${fields.join(', ')} FROM Package2 WHERE Id IN (${inClause}) ORDER BY NamespacePrefix, Name`, { tooling: true });
+            packages = (pkg2Result?.records ?? []);
+            versions = await Package.listVersions(connection, project, {
+                concise: false,
+                createdLastDays: undefined,
+                modifiedLastDays: undefined,
+                orderBy: 'Package2Id, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber',
+                isReleased: undefined,
+                verbose: true,
+                packages: targetPackage2Ids,
+            });
+        }
+    }
+    else {
+        packages = await Package.list(connection);
+        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