@simplysf/simply-package 3.0.2 → 3.0.3

package/lib/common/packageVersionService.js

@@ -1,347 +0,0 @@
-/*
- * Copyright (c) 2026, Clay Chipps.
- *
- * 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';
-/**
- * Load packages and package versions from the Dev Hub and build a {@link PackageVersionService}
- * over them.
- *
- * @param connection - The Dev Hub connection to query.
- * @param project - The SFDX project, used by `Package.listVersions` for alias resolution.
- * @param filterIds - When provided, only loads packages/versions relevant to these IDs (plus the
- * packages owning any given `subscriberVersionIds`) instead of every package in the Dev Hub.
- * @returns A version service backed by the loaded packages/versions.
- */
-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);
-        }
-    }
-    /** @returns The `namespace.Name` (or bare `Name`) alias for a `Package2` record. */
-    function computePackageAlias(pkg) {
-        return (pkg.NamespacePrefix ? pkg.NamespacePrefix + '.' : '') + pkg.Name;
-    }
-    /** @returns The `package@major.minor.patch-build[-branch]` alias for a package version. */
-    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;
-    }
-    /** Index a package version into `map`, nested by package, branch, and major/minor/patch/build. */
-    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);
-    }
-    /**
-     * Walk a version map block to the latest (highest-key) entry at any depth.
-     *
-     * @param block - A `VersionMap` node at any nesting depth (major/minor/patch/build).
-     * @returns The version record at the highest key, recursing into nested maps as needed.
-     */
-    // 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;
-    }
-    /** How far down a `VersionMap` to descend before returning a block to search for "latest" in. */
-    let ChunkLevel;
-    (function (ChunkLevel) {
-        ChunkLevel[ChunkLevel["Major"] = 1] = "Major";
-        ChunkLevel[ChunkLevel["Minor"] = 2] = "Minor";
-        ChunkLevel[ChunkLevel["Patch"] = 3] = "Patch";
-    })(ChunkLevel || (ChunkLevel = {}));
-    /**
-     * Descend into `map` for the given package/branch, stopping at `level` (or as far as the
-     * dependency's known major/minor version components allow).
-     *
-     * @returns The block at the requested depth, or `undefined` if nothing is indexed there.
-     */
-    function findBlock(map, package2Id, branch, dependency, level) {
-        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);
-    }
-    /** @returns A {@link VersionChoice} pointing directly at a specific package version. */
-    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,
-        };
-    }
-    /** @returns A {@link VersionChoice} whose value is a non-pinned `package2Id|major.minor.patch.LATEST` build spec. */
-    function makeLatestChoice(v, label) {
-        const seg = `${v.MajorVersion}.${v.MinorVersion}.${v.PatchVersion}.LATEST`;
-        return {
-            name: label,
-            value: `${v.Package2Id}|${seg}`,
-            short: seg,
-        };
-    }
-    /**
-     * @returns The latest released version choice for a package on the given branch (empty string
-     * for the main branch), or `undefined` if there isn't one or it's already in `seen`.
-     */
-    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);
-    }
-    /**
-     * @returns The latest version choice for a package on the given branch (empty string for the
-     * main branch) at the given precision level, or `undefined` if there isn't one or it's already
-     * in `seen`.
-     */
-    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) {
-            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

package/lib/common/packageVersionService.js.map

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

package/lib/common/sfdxProjectService.d.ts

@@ -1,19 +0,0 @@
-import { SfProject } from '@salesforce/core';
-import { DependencyChange } from '../schemas/manage/dependencyChange.js';
-import { ParsedDependency } from '../schemas/manage/parsedDependency.js';
-/** Read/write access to an SFDX project's package dependencies and related plugin config. */
-export type SfdxProjectService = {
-    getDependenciesByDirectory(): Map<string, ParsedDependency[]>;
-    getDependenciesToIgnore(): string[];
-    getBranchesWithReleasedVersions(): string[];
-    findAlias(id: string): string | undefined;
-    resolveAlias(alias: string): string;
-    applyChanges(changesByDirectory: Map<string, DependencyChange[]>): Promise<void>;
-};
-/**
- * Load an SFDX project's `sfdx-project.json` and build an {@link SfdxProjectService} over it.
- *
- * @param project - The SFDX project to load.
- * @returns A service for reading/writing the project's package dependencies.
- */
-export declare function buildProjectService(project: SfProject): Promise<SfdxProjectService>;

package/lib/common/sfdxProjectService.js

@@ -1,160 +0,0 @@
-/*
- * Copyright (c) 2026, Clay Chipps.
- *
- * 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 { isNamedPackagingDirectory } from '@salesforce/core';
-import { parseDependency } from '../schemas/manage/parsedDependency.js';
-import { PACKAGE_PREFIX_SUBSCRIBER_PACKAGE_VERSION } from './packageUtils.js';
-/**
- * Load an SFDX project's `sfdx-project.json` and build an {@link SfdxProjectService} over it.
- *
- * @param project - The SFDX project to load.
- * @returns A service for reading/writing the project's package dependencies.
- */
-export async function buildProjectService(project) {
-    const projectJson = await project.retrieveSfProjectJson();
-    const contents = projectJson.getContents();
-    /** @returns The project's `packageAliases` map, or an empty object if there isn't one. */
-    function getAliases() {
-        return contents.packageAliases ?? {};
-    }
-    /** @returns The ID `alias` resolves to, or `alias` itself if it isn't a known alias. */
-    function resolveAlias(alias) {
-        return project.getPackageIdFromAlias(alias) ?? alias;
-    }
-    /** @returns The first alias in `packageAliases` that resolves to `id`, if any. */
-    function findAlias(id) {
-        const aliases = getAliases();
-        for (const [k, v] of Object.entries(aliases)) {
-            if (v === id)
-                return k;
-        }
-        return undefined;
-    }
-    /** @returns Every package directory's parsed dependencies, keyed by directory path. */
-    function getDependenciesByDirectory() {
-        const result = new Map();
-        for (const dir of project.getPackageDirectories()) {
-            const deps = isNamedPackagingDirectory(dir) ? (dir.dependencies ?? []) : [];
-            const parsed = [];
-            for (const dep of deps) {
-                const resolvedPackage = project.getPackageIdFromAlias(dep.package) ?? dep.package;
-                parsed.push(parseDependency(resolvedPackage, dep.versionNumber));
-            }
-            result.set(dir.path, parsed);
-        }
-        return result;
-    }
-    /**
-     * @param keyPath - A dot-delimited path into `sfdx-project.json`'s contents, e.g.
-     * `plugins.simply.dependencies.ignore`.
-     * @returns The value at `keyPath`, or `undefined` if any segment along the path is missing.
-     */
-    function getPluginConfig(keyPath) {
-        const parts = keyPath.split('.');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let current = contents;
-        for (const part of parts) {
-            if (current == null || typeof current !== 'object')
-                return undefined;
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
-            current = current[part];
-        }
-        return current;
-    }
-    /** @returns Package2Ids/aliases configured under `plugins.simply.dependencies.ignore`. */
-    function getDependenciesToIgnore() {
-        return getPluginConfig('plugins.simply.dependencies.ignore') ?? [];
-    }
-    /** @returns Branch names configured under `plugins.simply.package.brancheswithreleasedversions`. */
-    function getBranchesWithReleasedVersions() {
-        return getPluginConfig('plugins.simply.package.brancheswithreleasedversions') ?? [];
-    }
-    /**
-     * Apply a set of dependency version changes to the in-memory project JSON and write it back to
-     * disk, updating each affected directory's dependency entries and `packageAliases` as needed.
-     *
-     * @param changesByDirectory - The changes to apply, keyed by package directory path.
-     */
-    async function applyChanges(changesByDirectory) {
-        // Deep-clone both structures so we can mutate them freely before calling set()
-        const updatedDirs = JSON.parse(JSON.stringify(contents.packageDirectories ?? []));
-        const updatedAliases = { ...getAliases() };
-        for (const [dirPath, changes] of changesByDirectory) {
-            // `dirPath` comes from `SfProject.getPackageDirectories()`, which normalizes the path to the
-            // OS separator. The raw JSON on disk always uses forward slashes, so compare both
-            // slash-normalized to avoid a false mismatch (and a silent no-op write) on Windows.
-            const dir = updatedDirs.find((d) => normalizePathSep(d['path']) === normalizePathSep(dirPath));
-            if (!dir)
-                continue;
-            const deps = (dir['dependencies'] ?? []);
-            for (const change of changes) {
-                const dep = deps.find((d) => resolveAlias(d['package']) === change.oldDependency.package2Id ||
-                    resolveAlias(d['package']) === change.oldDependency.subscriberPackageVersionId);
-                if (!dep)
-                    continue;
-                if (change.newSubscriberPackageVersionId) {
-                    // Pinned version: set alias, clear versionNumber
-                    dep['package'] = change.newAlias;
-                    delete dep['versionNumber'];
-                    updatedAliases[change.newAlias] = change.newSubscriberPackageVersionId;
-                    // Add package-level alias if provided
-                    if (change.newPackage2Id) {
-                        const pkgAlias = change.newAlias.split('@')[0];
-                        if (pkgAlias && !updatedAliases[pkgAlias]) {
-                            updatedAliases[pkgAlias] = change.newPackage2Id;
-                        }
-                    }
-                    // Remove old version alias if it changed and pointed to a subscriber package version
-                    if (change.oldAlias !== change.newAlias) {
-                        const oldTarget = updatedAliases[change.oldAlias];
-                        if (oldTarget?.startsWith(PACKAGE_PREFIX_SUBSCRIBER_PACKAGE_VERSION)) {
-                            delete updatedAliases[change.oldAlias];
-                        }
-                    }
-                }
-                else if (change.newPackage2Id && change.newVersionNumber) {
-                    // Non-pinned version: set package 0Ho alias and versionNumber
-                    dep['package'] = change.newAlias;
-                    dep['versionNumber'] = change.newVersionNumber;
-                    updatedAliases[change.newAlias] = change.newPackage2Id;
-                    if (change.oldAlias !== change.newAlias) {
-                        const oldTarget = updatedAliases[change.oldAlias];
-                        if (oldTarget?.startsWith(PACKAGE_PREFIX_SUBSCRIBER_PACKAGE_VERSION)) {
-                            delete updatedAliases[change.oldAlias];
-                        }
-                    }
-                }
-            }
-        }
-        const sortedAliases = Object.fromEntries(Object.entries(updatedAliases).sort(([a], [b]) => a.localeCompare(b)));
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
-        projectJson.set('packageDirectories', updatedDirs);
-        projectJson.set('packageAliases', sortedAliases);
-        await projectJson.write();
-    }
-    return {
-        getDependenciesByDirectory,
-        getDependenciesToIgnore,
-        getBranchesWithReleasedVersions,
-        findAlias,
-        resolveAlias,
-        applyChanges,
-    };
-}
-/** @returns `path` with backslashes converted to forward slashes, for OS-agnostic path comparison. */
-function normalizePathSep(path) {
-    return path.replace(/\\/g, '/');
-}
-//# sourceMappingURL=sfdxProjectService.js.map

package/lib/common/sfdxProjectService.js.map

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

package/lib/schemas/manage/dependencyChange.d.ts

@@ -1,20 +0,0 @@
-import { ParsedDependency } from './parsedDependency.js';
-/** A proposed (or applied) change to a single dependency's pinned/tracked version. */
-export type DependencyChange = {
-    oldAlias: string;
-    oldDependency: ParsedDependency;
-    newAlias: string;
-    newSubscriberPackageVersionId?: string;
-    newPackage2Id?: string;
-    newVersionNumber?: string;
-    isSameAsOld: boolean;
-};
-/** Per-package-directory summary returned by `simply package dependencies manage`. */
-export type PackageDependenciesManageResult = {
-    packageDirectory: string;
-    changes: Array<{
-        oldAlias: string;
-        newAlias: string;
-        changed: boolean;
-    }>;
-};

package/lib/schemas/manage/dependencyChange.js

@@ -1,17 +0,0 @@
-/*
- * Copyright (c) 2026, Clay Chipps.
- *
- * 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 {};
-//# sourceMappingURL=dependencyChange.js.map

package/lib/schemas/manage/dependencyChange.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dependencyChange.js","sourceRoot":"","sources":["../../../src/schemas/manage/dependencyChange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/schemas/manage/parsedDependency.d.ts

@@ -1,26 +0,0 @@
-/**
- * A `sfdx-project.json` package dependency entry, resolved and broken down into its component
- * parts (pinned `SubscriberPackageVersionId`, or `Package2Id` + version components).
- */
-export type ParsedDependency = {
-    subscriberPackageVersionId?: string;
-    package2Id?: string;
-    versionNumber?: string;
-    majorVersion?: number;
-    minorVersion?: number;
-    patchVersion?: number;
-    buildVersion?: number;
-    isLatest: boolean;
-    isPinned: boolean;
-};
-/**
- * Parse a resolved dependency (alias already resolved to an ID) into a {@link ParsedDependency}.
- *
- * @param resolvedPackage - The dependency's `package` field, already resolved from an alias to
- * either a `SubscriberPackageVersionId` (04t) or `Package2Id` (0Ho).
- * @param versionNumber - The dependency's `versionNumber` field, if `resolvedPackage` is a
- * `Package2Id`. Ignored for pinned `SubscriberPackageVersionId` dependencies.
- * @returns The parsed dependency. Neither `subscriberPackageVersionId` nor `package2Id` is set
- * if `resolvedPackage` doesn't match either prefix.
- */
-export declare function parseDependency(resolvedPackage: string, versionNumber?: string): ParsedDependency;