Class Package

Provides the ability to list, create, update, delete, convert, and get version ancestry for a 2nd generation package.

Examples

Create a new instance and get the ID (0Ho):

const id = new Package({connection, project, packageOrAliasId}).getId();

Create a new package in the org:

const myPkg = await Package.create(connection, project, options);

List all packages in the org:

const pkgList = await Package.list(connection);

Index

Constructors

constructor

Methods

delete getId getPackageData getPackageVersions getType undelete update convert create downloadPackageVersionMetadata getAncestry list listVersions

Constructors

constructor

new Package(options): Package
Parameters
- options: PackageOptions
Returns Package
- Defined in src/package/package.ts:83

Methods

delete

delete(): Promise<SaveResult>
Deletes the package.

Returns Promise<SaveResult>
- Defined in src/package/package.ts:258

getId

getId(): string
Returns the package ID of the package.

Returns string
package ID (0Ho)
- Defined in src/package/package.ts:223

getPackageData

getPackageData(force?): Promise<undefined | Package2>
Returns the package data for the package.
Parameters
- force: boolean = false
  force a refresh of the package data
Returns Promise<undefined | Package2>
- Defined in src/package/package.ts:305

getPackageVersions

getPackageVersions(options?): Promise<PackageVersionListResult[]>
Returns the list of package versions for the package. See PackageVersionListOptions for list options
Parameters
- Optional options: PackageVersionListOptions
Returns Promise<PackageVersionListResult[]>
- Defined in src/package/package.ts:243

getType

getType(): Promise<undefined | PackageType>
Returns the package type of the package.

Returns Promise<undefined | PackageType>
- Defined in src/package/package.ts:232

undelete

undelete(): Promise<SaveResult>
Un-Deletes the package.

Returns Promise<SaveResult>
- Defined in src/package/package.ts:266

update

update(options): Promise<SaveResult>
Updates the package using the values defined in the options. See PackageUpdateOptions for update options.
Parameters
- options: PackageUpdateOptions
Returns Promise<SaveResult>
- Defined in src/package/package.ts:276

`Static` convert

convert(pkgId, connection, options, project?): Promise<PackageVersionCreateRequestResult>
Convert a 1st generation package to a 2nd generation package. See ConvertPackageOptions for conversion options.
Parameters
- pkgId: string
  the 1GP package ID (033) of the package to convert
- connection: Connection<Schema>
- options: ConvertPackageOptions
  ConvertPackageOptions
- Optional project: SfProject
Returns Promise<PackageVersionCreateRequestResult>
- Defined in src/package/package.ts:188

`Static` create

create(connection, project, options): Promise<{
Id: string;
}>
Create a new package.
Parameters
- connection: Connection<Schema>
  instance of Connection
- project: SfProject
  instance of SfProject
- options: PackageCreateOptions
  options for creating a package - see PackageCreateOptions
Returns Promise<{
Id: string;
}>
Package
- Defined in src/package/package.ts:108

`Static` downloadPackageVersionMetadata

downloadPackageVersionMetadata(project, options, connection): Promise<ConvertResult>
Download the metadata files for a previously published package version, convert them to source format, and put them into a new project folder within the sfdx project.
Parameters
- project: SfProject
- options: PackageVersionMetadataDownloadOptions
  PackageVersionMetadataDownloadOptions
- connection: Connection<Schema>
Returns Promise<ConvertResult>
- Defined in src/package/package.ts:205

`Static` getAncestry

getAncestry(packageId, project, connection): Promise<PackageAncestry>
create a PackageAncestry instance
Parameters
- packageId: string
  to get version information for
- project: SfProject
  SfProject instance
- connection: Connection<Schema>
  Hub Org Connection
Returns Promise<PackageAncestry>
- Defined in src/package/package.ts:167

`Static` list

list(connection): Promise<Package2[]>
Returns all the packages that are available in the org, up to 10,000. If more records are needed use the SF_ORG_MAX_QUERY_LIMIT env var.
Parameters
- connection: Connection<Schema>
Returns Promise<Package2[]>
- Defined in src/package/package.ts:122

`Static` listVersions

listVersions(connection, project, options?): Promise<PackageVersionListResult[]>
Returns the package versions in the org. See PackageVersionListOptions for list options
Parameters
- connection: Connection<Schema>
  connection to the org
- project: SfProject
  instance of SfProject
- Optional options: PackageVersionListOptions
  see PackageVersionListOptions
Returns Promise<PackageVersionListResult[]>
- Defined in src/package/package.ts:137

Class Package

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Package

Methods

delete

Returns Promise<SaveResult>

getId

Returns string

getPackageData

Parameters

Returns Promise<undefined | Package2>

getPackageVersions

Parameters

Returns Promise<PackageVersionListResult[]>

getType

Returns Promise<undefined | PackageType>

undelete

Returns Promise<SaveResult>

update

Parameters

Returns Promise<SaveResult>

Static convert

Parameters

Returns Promise<PackageVersionCreateRequestResult>

Static create

Parameters

Returns Promise<{ Id: string; }>

Static downloadPackageVersionMetadata

Parameters

Returns Promise<ConvertResult>

Static getAncestry

Parameters

Returns Promise<PackageAncestry>

Static list

Parameters

Returns Promise<Package2[]>

Static listVersions

Parameters

Returns Promise<PackageVersionListResult[]>

Settings

Member Visibility

Theme

On This Page

`Static` convert

`Static` create

Returns Promise<{
Id: string;
}>

`Static` downloadPackageVersionMetadata

`Static` getAncestry

`Static` list

`Static` listVersions