simply-package-core

Package/package-version alias resolution, sfdx-project.json dependency management, package dependency installation, and Dev Hub version lookup logic. Full signatures and types are in the API reference.

npm install @simplysf/simply-package-core

Every example below assumes you already have an authenticated @salesforce/core Connection/ SfProject — see Get Started.

Finding where a package is declared

import { findPackageVersions, splitPackageAlias } from '@simplysf/simply-package-core';

const project = await sfProject.retrieveSfProjectJson();
const matches = findPackageVersions(project.getContents(), 'MyPackage');

Building a Dev Hub version-lookup service

import { buildVersionService } from '@simplysf/simply-package-core';

const versionService = await buildVersionService(connection, sfProject);
const alias = versionService.getVersionAlias('04t000000000001AAA');

Reading and updating package dependencies

import { buildProjectService } from '@simplysf/simply-package-core';

const projectService = await buildProjectService(sfProject);
const dependenciesByDirectory = projectService.getDependenciesByDirectory();

Installing a project’s package dependencies

The engine behind sf simply package dependencies install, without the CLI. Dependencies are resolved from sfdx-project.json (aliases, or a Dev Hub for package + versionNumber pairs), compared against what the org already has, and installed one at a time.

import { Duration } from '@salesforce/kit';
import { installPackageDependencies } from '@simplysf/simply-package-core';

const results = await installPackageDependencies({
  project: sfProject,
  targetOrgConnection: connection,
  // Only invoked if a dependency is declared as package + versionNumber.
  targetDevHubConnection: async () => devHubOrg.getConnection(),
  installType: 'Upgrade', // or 'All' | 'Delta'
  installationKeys: { MyProtectedPackage: 'key' }, // alias or 04t id → key
  wait: Duration.minutes(120),
  retryAttempts: 2,
  progress: { info: console.log, warn: console.warn, stepStart: console.log },
  // Omit `prompts` to auto-approve the Delete-upgrade and external-sites confirmations.
});

for (const result of results) {
  console.log(`${result.PackageName}: ${result.Status}`);
}