@salesforce/packaging 1.0.16 → 1.1.0

package/lib/interfaces/packagingInterfacesAndType.d.ts

@@ -21,20 +21,20 @@ export interface IPackageVersion2GP {
     uninstall(): Promise<void>;
     update(): Promise<void>;
 }
-export declare type PackageOptions = {
+export type PackageOptions = {
     connection: Connection;
     project: SfProject;
     packageAliasOrId: string;
 };
-export declare type PackageUpdateOptions = {
+export type PackageUpdateOptions = {
     Id: string;
     Name?: string;
     Description?: string;
     PackageErrorUsername?: string;
 };
-export declare type PackageIdType = 'PackageId' | 'SubscriberPackageVersionId' | 'PackageInstallRequestId' | 'PackageUninstallRequestId';
-export declare type PackageVersionOptions1GP = Record<string, unknown>;
-export declare type PackageVersionCreateRequestResult = {
+export type PackageIdType = 'PackageId' | 'SubscriberPackageVersionId' | 'PackageInstallRequestId' | 'PackageUninstallRequestId';
+export type PackageVersionOptions1GP = Record<string, unknown>;
+export type PackageVersionCreateRequestResult = {
     Id: string;
     Status: Package2VersionStatus;
     Package2Id: string;
@@ -48,17 +48,17 @@ export declare type PackageVersionCreateRequestResult = {
     CreatedBy: string;
 };
 export declare const PackageVersionCreateRequestResultInProgressStatuses: PackagingSObjects.Package2VersionStatus[];
-export declare type PackageVersionCreateRequestError = {
+export type PackageVersionCreateRequestError = {
     Message: string;
 };
-export declare type PackageVersionCreateEventData = {
+export type PackageVersionCreateEventData = {
     id: string;
     packageUpdated?: boolean;
     packageVersionCreateRequestResult: PackageVersionCreateRequestResult;
     message?: string;
     timeRemaining?: Duration;
 };
-export declare type PackageVersionListResult = {
+export type PackageVersionListResult = {
     Id: string;
     Package2Id: string;
     SubscriberPackageVersionId: string;
@@ -92,9 +92,10 @@ export declare type PackageVersionListResult = {
     ReleaseVersion?: string;
     BuildDurationInSeconds?: number;
     HasMetadataRemoved?: boolean;
+    Language?: string;
 };
-export declare type PackageInstallCreateRequest = Partial<Pick<PackageInstallRequest, 'ApexCompileType' | 'EnableRss' | 'NameConflictResolution' | 'PackageInstallSource' | 'Password' | 'SecurityType' | 'UpgradeType'>> & Pick<PackagingSObjects.PackageInstallRequest, 'SubscriberPackageVersionKey'>;
-export declare type Package1Display = {
+export type PackageInstallCreateRequest = Partial<Pick<PackageInstallRequest, 'ApexCompileType' | 'EnableRss' | 'NameConflictResolution' | 'PackageInstallSource' | 'Password' | 'SecurityType' | 'UpgradeType'>> & Pick<PackagingSObjects.PackageInstallRequest, 'SubscriberPackageVersionKey'>;
+export type Package1Display = {
     MetadataPackageVersionId: string;
     MetadataPackageId: string;
     Name: string;
@@ -102,8 +103,8 @@ export declare type Package1Display = {
     ReleaseState: string;
     BuildNumber: number;
 };
-export declare type PackageType = 'Managed' | 'Unlocked';
-export declare type PackageCreateOptions = {
+export type PackageType = 'Managed' | 'Unlocked';
+export type PackageCreateOptions = {
     name: string;
     description: string;
     noNamespace: boolean;
@@ -112,7 +113,7 @@ export declare type PackageCreateOptions = {
     errorNotificationUsername: string;
     path: string;
 };
-export declare type PackageDescriptorJson = Partial<NamedPackageDir> & Partial<{
+export type PackageDescriptorJson = Partial<NamedPackageDir> & Partial<{
     id: string;
     features: string[];
     orgPreferences: string[];
@@ -128,8 +129,9 @@ export declare type PackageDescriptorJson = Partial<NamedPackageDir> & Partial<{
     subscriberPackageVersionId: string;
     packageId: string;
     versionName: string;
+    language?: string;
 }>;
-export declare type PackageVersionCreateRequest = {
+export type PackageVersionCreateRequest = {
     Package2Id: string;
     VersionInfo: string;
     Tag: string;
@@ -137,10 +139,11 @@ export declare type PackageVersionCreateRequest = {
     InstallKey: string;
     Instance: string;
     SourceOrg: string;
+    Language?: string;
     CalculateCodeCoverage: boolean;
     SkipValidation: boolean;
 };
-export declare type PackageVersionListOptions = {
+export type PackageVersionListOptions = {
     orderBy: string;
     modifiedLastDays: number;
     createdLastDays: number;
@@ -149,18 +152,18 @@ export declare type PackageVersionListOptions = {
     concise: boolean;
     isReleased: boolean;
 };
-export declare type PackageVersionUpdateOptions = {
+export type PackageVersionUpdateOptions = {
     InstallKey?: string;
     VersionName?: string;
     VersionDescription?: string;
     Branch?: string;
     Tag?: string;
 };
-export declare type ListPackageVersionOptions = PackageVersionListOptions & {
+export type ListPackageVersionOptions = PackageVersionListOptions & {
     connection: Connection;
 };
-export declare type PackageSaveResult = SaveResult;
-export declare type PackageVersionCreateRequestOptions = {
+export type PackageSaveResult = SaveResult;
+export type PackageVersionCreateRequestOptions = {
     path: string;
     preserve: boolean;
     definitionfile?: string;
@@ -168,7 +171,7 @@ export declare type PackageVersionCreateRequestOptions = {
     branch?: string;
     skipancestorcheck?: boolean;
 };
-export declare type PackageInstallOptions = {
+export type PackageInstallOptions = {
     /**
      * The frequency to poll the org for package publish status. If providing a number
      * it is interpreted in milliseconds.
@@ -190,7 +193,7 @@ export declare type PackageInstallOptions = {
      */
     pollingTimeout?: number | Duration;
 };
-export declare type MDFolderForArtifactOptions = {
+export type MDFolderForArtifactOptions = {
     packageName?: string;
     sourceDir?: string;
     outputDir?: string;
@@ -199,7 +202,7 @@ export declare type MDFolderForArtifactOptions = {
     metadataPaths?: string[];
     deploydir?: string;
 };
-export declare type PackageVersionOptions = {
+export type PackageVersionOptions = {
     connection: Connection;
     /**
      * Can be one of:
@@ -210,12 +213,12 @@ export declare type PackageVersionOptions = {
     idOrAlias: string;
     project: SfProject;
 };
-export declare type SubscriberPackageVersionOptions = {
+export type SubscriberPackageVersionOptions = {
     connection: Connection;
     aliasOrId: string;
     password: Optional<string>;
 };
-export declare type ConvertPackageOptions = {
+export type ConvertPackageOptions = {
     installationKey: string;
     definitionfile: string;
     installationKeyBypass: boolean;
@@ -223,7 +226,7 @@ export declare type ConvertPackageOptions = {
     buildInstance: string;
     frequency?: Duration;
 };
-export declare type PackageVersionCreateOptions = {
+export type PackageVersionCreateOptions = {
     connection: Connection;
     project: SfProject;
 } & Partial<{
@@ -233,6 +236,7 @@ export declare type PackageVersionCreateOptions = {
     definitionfile: string;
     installationkey: string;
     installationkeybypass: boolean;
+    language?: string;
     packageId: string;
     path: string;
     postinstallscript: string;
@@ -250,29 +254,29 @@ export declare type PackageVersionCreateOptions = {
     versionnumber: string;
     profileApi: PackageProfileApi;
 }>;
-export declare type PackageVersionCreateRequestQueryOptions = {
+export type PackageVersionCreateRequestQueryOptions = {
     createdlastdays?: number;
     connection?: Connection;
     status?: 'Queued' | 'InProgress' | 'Success' | 'Error';
     id?: string;
 };
-export declare type ProfileApiOptions = {
+export type ProfileApiOptions = {
     project: SfProject;
     includeUserLicenses: boolean;
     generateProfileInformation: boolean;
 };
-export declare type PackageVersionReportResult = Partial<PackagingSObjects.Package2Version> & {
+export type PackageVersionReportResult = Partial<PackagingSObjects.Package2Version> & {
     Package2: Partial<PackagingSObjects.Package2>;
     SubscriberPackageVersion?: Pick<PackagingSObjects.SubscriberPackageVersion, 'Dependencies'>;
     Version: string;
     AncestorVersion?: string;
     PackageType: PackageType;
 };
-export declare type PackageVersionCreateReportProgress = PackageVersionCreateRequestResult & {
+export type PackageVersionCreateReportProgress = PackageVersionCreateRequestResult & {
     remainingWaitTime: Duration;
 };
-export declare type Package1VersionCreateRequest = Pick<PackagingSObjects.PackageUploadRequest, 'VersionName' | 'MetadataPackageId'> & Partial<Pick<PackagingSObjects.PackageUploadRequest, 'Description' | 'MajorVersion' | 'MinorVersion' | 'IsReleaseVersion' | 'ReleaseNotesUrl' | 'PostInstallUrl' | 'Password'>>;
-export declare type InstalledPackages = {
+export type Package1VersionCreateRequest = Pick<PackagingSObjects.PackageUploadRequest, 'VersionName' | 'MetadataPackageId'> & Partial<Pick<PackagingSObjects.PackageUploadRequest, 'Description' | 'MajorVersion' | 'MinorVersion' | 'IsReleaseVersion' | 'ReleaseNotesUrl' | 'PostInstallUrl' | 'Password'>>;
+export type InstalledPackages = {
     Id: string;
     SubscriberPackageId: string;
     SubscriberPackageVersionId: string;
@@ -280,10 +284,10 @@ export declare type InstalledPackages = {
     SubscriberPackage?: PackagingSObjects.SubscriberPackage;
     SubscriberPackageVersion?: Omit<MetadataPackageVersion, 'MetadataPackageId' | 'ReleaseState' | 'IsDeprecated'>;
 };
-export declare type CodeCoverage = null | {
+export type CodeCoverage = null | {
     apexCodeCoveragePercentage: number;
 };
-export declare type CodeCoveragePercentages = null | {
+export type CodeCoveragePercentages = null | {
     codeCovPercentages: [
         {
             className: string;
@@ -291,7 +295,7 @@ export declare type CodeCoveragePercentages = null | {
         }
     ];
 };
-export declare type PackageAncestryNodeOptions = Attributes & {
+export type PackageAncestryNodeOptions = Attributes & {
     AncestorId?: string;
     SubscriberPackageVersionId?: string;
     MajorVersion?: string | number;
@@ -300,17 +304,17 @@ export declare type PackageAncestryNodeOptions = Attributes & {
     BuildNumber?: string | number;
     depthCounter?: number;
 };
-export declare type PackageAncestryData = Omit<PackageAncestryNodeOptions, 'AncestorId'>;
-export declare type PackageAncestryNodeData = {
+export type PackageAncestryData = Omit<PackageAncestryNodeOptions, 'AncestorId'>;
+export type PackageAncestryNodeData = {
     data: PackageAncestryNodeOptions;
     children: PackageAncestryNodeData[];
 };
-export declare type PackageAncestryOptions = {
+export type PackageAncestryOptions = {
     packageId: string;
     project: SfProject;
     connection: Connection;
 };
-export declare type AncestryRepresentationProducerOptions = {
+export type AncestryRepresentationProducerOptions = {
     [key: string]: unknown;
     node: PackageAncestryNode;
     depth?: number;

package/lib/interfaces/packagingSObjects.d.ts

@@ -50,6 +50,7 @@ export declare namespace PackagingSObjects {
         ReleaseVersion: number;
         BuildDurationInSeconds: number;
         HasMetadataRemoved: boolean;
+        Language: string;
     };
     enum Package2VersionStatus {
         queued = "Queued",
@@ -82,6 +83,7 @@ export declare namespace PackagingSObjects {
         SkipValidation: boolean;
         IsConversionRequest: boolean;
         VersionInfo: string;
+        Language: string;
     };
     type Package2VersionCreateRequestError = {
         Id: string;

package/lib/package/packageCreate.d.ts

@@ -1,6 +1,6 @@
 import { Connection, NamedPackageDir, PackageDir, SfProject } from '@salesforce/core';
 import { PackageCreateOptions, PackagingSObjects } from '../interfaces';
-declare type Package2Request = Pick<PackagingSObjects.Package2, 'Name' | 'Description' | 'NamespacePrefix' | 'ContainerOptions' | 'IsOrgDependent' | 'PackageErrorUsername'>;
+type Package2Request = Pick<PackagingSObjects.Package2, 'Name' | 'Description' | 'NamespacePrefix' | 'ContainerOptions' | 'IsOrgDependent' | 'PackageErrorUsername'>;
 export declare function createPackageRequestFromContext(project: SfProject, options: PackageCreateOptions): Package2Request;
 /**
  * Create packageDirectory json entry for this package that can be written to sfdx-project.json

package/lib/package/packageUninstall.d.ts

@@ -1,7 +1,7 @@
 import { Connection } from '@salesforce/core';
 import { Duration } from '@salesforce/kit';
 import { PackagingSObjects } from '../interfaces';
-declare type UninstallResult = PackagingSObjects.SubscriberPackageVersionUninstallRequest;
+type UninstallResult = PackagingSObjects.SubscriberPackageVersionUninstallRequest;
 export declare function getUninstallErrors(conn: Connection, id: string): Promise<Array<{
     Message: string;
 }>>;

package/lib/package/packageVersion.d.ts

@@ -1,7 +1,7 @@
 import { Connection, SfProject } from '@salesforce/core';
 import { Duration } from '@salesforce/kit';
 import { PackageSaveResult, PackageType, PackageVersionCreateOptions, PackageVersionCreateRequestQueryOptions, PackageVersionCreateRequestResult, PackageVersionOptions, PackageVersionReportResult, PackageVersionUpdateOptions, PackagingSObjects } from '../interfaces';
-declare type Package2Version = PackagingSObjects.Package2Version;
+type Package2Version = PackagingSObjects.Package2Version;
 export declare const Package2VersionFields: string[];
 /**
  * Provides the ability to create, update, delete, and promote 2nd

package/lib/package/packageVersionCreate.js

@@ -221,6 +221,7 @@ class PackageVersionCreate {
             SourceOrg: this.options.sourceorg,
             CalculateCodeCoverage: this.options.codecoverage || false,
             SkipValidation: this.options.skipvalidation || false,
+            Language: this.options.language,
         };
         if (preserveFiles) {
             const message = messages.getMessage('tempFileLocation', [packageVersTmpRoot]);
@@ -301,8 +302,9 @@ class PackageVersionCreate {
         // All dependencies for the packaging dir should be resolved to an 04t id to be passed to the server.
         // (see _retrieveSubscriberPackageVersionId for details)
         const dependencies = packageDescriptorJson.dependencies;
-        // branch can be set via options or descriptor; option takes precedence
+        // branch and language can be set via options or descriptor; option takes precedence
         this.options.branch = this.options.branch ?? packageDescriptorJson.branch;
+        this.options.language = this.options.language ?? packageDescriptorJson.language;
         const resultValues = await Promise.all(!dependencies ? [] : dependencies.map((dependency) => this.retrieveSubscriberPackageVersionId(dependency)));
         const ancestorId = await this.getAncestorId(packageDescriptorJson, this.options.project, this.options.versionnumber ?? packageDescriptorJson.versionNumber, this.options.skipancestorcheck);
         // If dependencies exist, the resultValues array will contain the dependencies populated with a resolved

package/lib/package/packageVersionList.js

@@ -12,16 +12,38 @@ const ts_types_1 = require("@salesforce/ts-types");
 const packageUtils_1 = require("../utils/packageUtils");
 core_1.Messages.importMessagesDirectory(__dirname);
 const messages = core_1.Messages.loadMessages('@salesforce/packaging', 'package_version_create');
-// Stripping CodeCoverage, HasPassedCodeCoverageCheck as they are causing a perf issue in 47.0+ W-6997762
-const DEFAULT_SELECT = 'SELECT Id, Package2Id, SubscriberPackageVersionId, Name, Package2.Name, Package2.NamespacePrefix, Package2.IsOrgDependent, ' +
-    'Description, Tag, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber, IsReleased, ' +
-    'CreatedDate, LastModifiedDate, IsPasswordProtected, AncestorId, ValidationSkipped, CreatedById ' +
-    'FROM Package2Version';
-const VERBOSE_SELECT = 'SELECT Id, Package2Id, SubscriberPackageVersionId, Name, Package2.Name, Package2.NamespacePrefix, ' +
-    'Description, Tag, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber, IsReleased, ' +
-    'CreatedDate, LastModifiedDate, IsPasswordProtected, CodeCoverage, HasPassedCodeCoverageCheck, AncestorId, ValidationSkipped, ' +
-    'ConvertedFromVersionId, Package2.IsOrgDependent, ReleaseVersion, BuildDurationInSeconds, HasMetadataRemoved, CreatedById ' +
-    'FROM Package2Version';
+const defaultFields = [
+    'Id',
+    'Package2Id',
+    'SubscriberPackageVersionId',
+    'Name',
+    'Package2.Name',
+    'Package2.NamespacePrefix',
+    'Package2.IsOrgDependent',
+    'Description',
+    'Tag',
+    'Branch',
+    'MajorVersion',
+    'MinorVersion',
+    'PatchVersion',
+    'BuildNumber',
+    'IsReleased',
+    'CreatedDate',
+    'LastModifiedDate',
+    'IsPasswordProtected',
+    'AncestorId',
+    'ValidationSkipped',
+    'CreatedById',
+];
+const verboseFields = [
+    'CodeCoverage',
+    'HasPassedCodeCoverageCheck',
+    'ConvertedFromVersionId',
+    'ReleaseVersion',
+    'BuildDurationInSeconds',
+    'HasMetadataRemoved',
+];
+const verbose57Fields = ['Language'];
 exports.DEFAULT_ORDER_BY_FIELDS = 'Package2Id, Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber';
 let logger;
 const getLogger = () => {
@@ -39,7 +61,15 @@ exports.listPackageVersions = listPackageVersions;
 function constructQuery(options) {
     // construct custom WHERE clause, if applicable
     const where = constructWhere(options.packages, options.createdLastDays, options.modifiedLastDays, options.isReleased);
-    return assembleQueryParts(options.verbose === true ? VERBOSE_SELECT : DEFAULT_SELECT, where, options.orderBy);
+    let queryFields = defaultFields;
+    if (options.verbose) {
+        queryFields = [...queryFields, ...verboseFields];
+        if (Number(options.connection.version) >= 57) {
+            queryFields = [...queryFields, ...verbose57Fields];
+        }
+    }
+    const query = `SELECT ${queryFields.toString()} FROM Package2Version`;
+    return assembleQueryParts(query, where, options.orderBy);
 }
 function assembleQueryParts(select, where, orderBy) {
     // construct ORDER BY clause

package/lib/utils/packageUtils.d.ts

@@ -4,11 +4,11 @@ import { SaveError } from 'jsforce';
 import { Duration } from '@salesforce/kit';
 import { PackageType, PackagingSObjects } from '../interfaces';
 export declare const VERSION_NUMBER_SEP = ".";
-export declare type IdRegistryValue = {
+export type IdRegistryValue = {
     prefix: string;
     label: string;
 };
-export declare type IdRegistry = {
+export type IdRegistry = {
     [key: string]: IdRegistryValue;
 };
 export declare const INSTALL_URL_BASE: SfdcUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/packaging",
-  "version": "1.0.16",
+  "version": "1.1.0",
   "description": "Packaging library for the Salesforce packaging platform",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",
@@ -39,7 +39,7 @@
   ],
   "dependencies": {
     "@oclif/core": "^1.20.4",
-    "@salesforce/core": "^3.31.19",
+    "@salesforce/core": "^3.32.6",
     "@salesforce/kit": "^1.8.0",
     "@salesforce/schemas": "^1.4.0",
     "@salesforce/source-deploy-retrieve": "^7.5.13",
@@ -58,7 +58,7 @@
     "xml2js": "^0.4.23"
   },
   "devDependencies": {
-    "@salesforce/cli-plugins-testkit": "^3.2.8",
+    "@salesforce/cli-plugins-testkit": "^3.2.12",
     "@salesforce/dev-config": "^3.1.0",
     "@salesforce/dev-scripts": "^3.1.0",
     "@salesforce/prettier-config": "^0.0.2",
@@ -68,10 +68,10 @@
     "@types/jszip": "^3.4.1",
     "@types/xml2js": "^0.4.11",
     "@typescript-eslint/eslint-plugin": "^5.40.1",
-    "@typescript-eslint/parser": "5.43.0",
+    "@typescript-eslint/parser": "5.46.0",
     "chai": "^4.3.7",
-    "commitizen": "^4.2.4",
-    "eslint": "^8.28.0",
+    "commitizen": "^4.2.6",
+    "eslint": "^8.29.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-config-salesforce": "^1.1.0",
     "eslint-config-salesforce-license": "^0.1.6",
@@ -82,12 +82,12 @@
     "husky": "^8.0.1",
     "mocha": "^10.0.0",
     "nyc": "^15.1.0",
-    "prettier": "^2.7.1",
+    "prettier": "^2.8.0",
     "pretty-quick": "^3.1.3",
     "shelljs": "0.8.5",
     "sinon": "14.0.2",
     "ts-node": "^10.9.1",
-    "typescript": "4.8.4"
+    "typescript": "4.9.4"
   },
   "publishConfig": {
     "access": "public"