fix: no nullish in template literal

package.json

@@ -42,13 +42,13 @@
   ],
   "dependencies": {
     "@jsforce/jsforce-node": "^3.2.0",
-    "@salesforce/core": "^8.2.3",
+    "@salesforce/core": "^8.2.7",
     "@salesforce/kit": "^3.1.6",
     "@salesforce/schemas": "^1.9.0",
     "@salesforce/source-deploy-retrieve": "^12.1.8",
-    "@salesforce/ts-types": "^2.0.10",
+    "@salesforce/ts-types": "^2.0.11",
     "@salesforce/types": "^1.2.0",
-    "fast-xml-parser": "^4.4.0",
+    "fast-xml-parser": "^4.4.1",
     "globby": "^11",
     "graphology": "^0.25.4",
     "graphology-traversal": "^0.3.1",
@@ -57,14 +57,14 @@
     "object-treeify": "^2"
   },
   "devDependencies": {
-    "@salesforce/cli-plugins-testkit": "^5.3.18",
-    "@salesforce/dev-scripts": "^10.2.2",
+    "@salesforce/cli-plugins-testkit": "^5.3.20",
+    "@salesforce/dev-scripts": "^10.2.8",
     "@types/globby": "^9.1.0",
     "@types/jszip": "^3.4.1",
-    "eslint-plugin-sf-plugin": "^1.18.11",
+    "eslint-plugin-sf-plugin": "^1.20.1",
     "shelljs": "0.8.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.3"
+    "typescript": "^5.5.4"
   },
   "publishConfig": {
     "access": "public"

src/package/packageAncestry.ts

@@ -320,7 +320,9 @@ export class PackageAncestry extends AsyncCreatable<PackageAncestryOptions> {
     // Check to see if the package is an unlocked package
     // if so, throw and error since ancestry only applies to managed packages
     await this.validatePackageType();
-    const normalQuery = `${SELECT_PACKAGE_VERSION} WHERE AncestorId = NULL AND Package2Id = '${this.requestedPackageId}' ${releasedOnlyFilter}`;
+    const normalQuery = `${SELECT_PACKAGE_VERSION} WHERE AncestorId = NULL AND Package2Id = '${
+      this.requestedPackageId ?? ''
+    }' ${releasedOnlyFilter}`;
     const subscriberPackageVersions = (
       await this.options.connection.tooling.query<PackageAncestryNode>(normalQuery)
     ).records?.map((record) => new PackageAncestryNode(record));

src/package/packageConvert.ts

@@ -205,19 +205,21 @@ export async function createPackageVersionCreateRequest(
   if (hasSeedMetadata) {
     // Zip the seedMetadataFolder folder and put the zip in {packageVersBlobDirectory}/{seedMetadataZipFile}
     Logger.childFromRoot('packageConvert:pollForStatusWithInterval').debug(
-      `Including metadata found in '${context.seedmetadata}'.`
+      `Including metadata found in '${context.seedmetadata ?? '<undefined seedmetadata>'}'.`
     );
     await pkgUtils.zipDir(seedMetadataFolder, seedMetadataZipFile);
   }
 
   await settingsGenerator.createDeploy();
   await settingsGenerator.createDeployPackageContents(apiVersion);
   await pkgUtils.zipDir(
-    `${settingsGenerator.getDestinationPath()}${path.sep}${settingsGenerator.getShapeDirName()}`,
+    `${settingsGenerator.getDestinationPath() ?? ''}${path.sep}${settingsGenerator.getShapeDirName()}`,
     settingsZipFile
   );
 
-  const shapeDirectory = `${settingsGenerator.getDestinationPath()}${path.sep}${settingsGenerator.getShapeDirName()}`;
+  const shapeDirectory = `${settingsGenerator.getDestinationPath() ?? ''}${
+    path.sep
+  }${settingsGenerator.getShapeDirName()}`;
   const currentPackageXml = await fs.promises.readFile(path.join(shapeDirectory, 'package.xml'), 'utf8');
   await fs.promises.writeFile(path.join(packageVersMetadataFolder, 'package.xml'), currentPackageXml, 'utf-8');
   // Zip the packageVersMetadataFolder folder and put the zip in {packageVersBlobDirectory}/package.zip

src/package/packageVersion.ts

@@ -145,7 +145,7 @@ export class PackageVersion {
       frequency: Duration.seconds(0),
       timeout: Duration.seconds(0),
     }
-  ): Promise<Partial<PackageVersionCreateRequestResult>> {
+  ): Promise<PackageVersionCreateRequestResult> {
     const pvc = new PackageVersionCreate({ ...options });
     const createResult = await pvc.createPackageVersion();
 
@@ -411,8 +411,9 @@ export class PackageVersion {
   }
 
   private static getPackage2VersionFields(connection: Connection): string[] {
-    const apiVersion = connection.getApiVersion();
-    return Package2VersionFields.filter((field) => (apiVersion > '60.0' ? true : field !== 'ValidatedAsync'));
+    return parseInt(connection.getApiVersion(), 10) > 60
+      ? Package2VersionFields
+      : Package2VersionFields.filter((field) => field !== 'ValidatedAsync');
   }
 
   /**
@@ -460,7 +461,7 @@ export class PackageVersion {
     if (!this.packageType) {
       this.packageType = (
         await this.connection.singleRecordQuery<Package2>(
-          `select ContainerOptions from Package2 where Id = '${await this.getPackageId()}' limit 1`,
+          `select ContainerOptions from Package2 where Id = '${(await this.getPackageId()) ?? ''}' limit 1`,
           { tooling: true }
         )
       ).ContainerOptions;
@@ -476,34 +477,29 @@ export class PackageVersion {
    * @returns Package2Version
    */
   public async getData(force = false): Promise<Package2Version> | never {
-    let is05i = false;
     if (!this.data || force) {
       // validate ID
       if (this.id.startsWith('04t')) {
         validateId(BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID, this.id);
-        is05i = false;
       } else if (this.id.startsWith('05i')) {
         validateId(BY_LABEL.PACKAGE_VERSION_ID, this.id);
-        is05i = true;
       } else {
         throw messages.createError('errorInvalidPackageVersionId', [this.options.idOrAlias]);
       }
-      let queryConfig: { id: string; clause: string; label1: string; label2: string };
-      if (is05i) {
-        queryConfig = {
-          id: this.id,
-          clause: `Id = '${this.id}'`,
-          label1: BY_LABEL.PACKAGE_VERSION_ID.label,
-          label2: BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID.label,
-        };
-      } else {
-        queryConfig = {
-          id: this.id,
-          clause: `SubscriberPackageVersionId = '${this.id}'`,
-          label1: BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID.label,
-          label2: BY_LABEL.PACKAGE_VERSION_ID.label,
-        };
-      }
+      const queryConfig: { id: string; clause: string; label1: string; label2: string } = this.id.startsWith('05i')
+        ? {
+            id: this.id,
+            clause: `Id = '${this.id}'`,
+            label1: BY_LABEL.PACKAGE_VERSION_ID.label,
+            label2: BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID.label,
+          }
+        : {
+            id: this.id,
+            clause: `SubscriberPackageVersionId = '${this.id}'`,
+            label1: BY_LABEL.SUBSCRIBER_PACKAGE_VERSION_ID.label,
+            label2: BY_LABEL.PACKAGE_VERSION_ID.label,
+          };
+
       const allFields = PackageVersion.getPackage2VersionFields(this.connection).toString();
       const query = `SELECT ${allFields} FROM Package2Version WHERE ${queryConfig.clause} LIMIT 1`;
       try {
@@ -633,7 +629,9 @@ export class PackageVersion {
           PatchVersion: string;
           BuildNumber: string;
         }>(
-          `SELECT Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber FROM Package2Version WHERE SubscriberPackageVersionId='${results.SubscriberPackageVersionId}'`
+          `SELECT Branch, MajorVersion, MinorVersion, PatchVersion, BuildNumber FROM Package2Version WHERE SubscriberPackageVersionId='${
+            results.SubscriberPackageVersionId ?? ''
+          }'`
         )
       ).records[0];
 

src/package/packageVersionCreate.ts

@@ -80,7 +80,7 @@ export class PackageVersionCreate {
     this.metadataResolver = new MetadataResolver();
   }
 
-  public createPackageVersion(): Promise<Partial<PackageVersionCreateRequestResult>> {
+  public createPackageVersion(): Promise<PackageVersionCreateRequestResult> {
     try {
       return this.packageVersionCreate();
     } catch (err) {
@@ -163,6 +163,7 @@ export class PackageVersionCreate {
     return pkgVerQueryResult.records[0].SubscriberPackageVersionId;
   }
 
+  /** side effect: removes properties from the passed in dependency! */
   private async resolveSubscriberPackageVersionId(dependency: PackageDescriptorJson): Promise<PackageDescriptorJson> {
     await this.validateDependencyValues(dependency);
     if (dependency.subscriberPackageVersionId) {
@@ -581,14 +582,15 @@ export class PackageVersionCreate {
       await settingsGenerator.createDeploy();
       await settingsGenerator.createDeployPackageContents(this.apiVersionFromPackageXml);
       await zipDir(
-        `${settingsGenerator.getDestinationPath()}${path.sep}${settingsGenerator.getShapeDirName()}`,
+        `${settingsGenerator.getDestinationPath() ?? ''}${path.sep}${settingsGenerator.getShapeDirName()}`,
         settingsZipFile
       );
     }
     // Zip the Version Info and package.zip files into another zip
     await zipDir(packageVersBlobDirectory, packageVersBlobZipFile);
   }
 
+  /** side effect: modifies the passed in parameter! */
   private resolveBuildUserPermissions(packageDescriptorJson: PackageDescriptorJson): void {
     // Process permissionSet and permissionSetLicenses that should be enabled when running Apex tests
     // This only applies if code coverage is enabled
@@ -633,7 +635,7 @@ export class PackageVersionCreate {
   }
 
   // eslint-disable-next-line complexity
-  private async packageVersionCreate(): Promise<Partial<PackageVersionCreateRequestResult>> {
+  private async packageVersionCreate(): Promise<PackageVersionCreateRequestResult> {
     // For the first rollout of validating sfdx-project.json data against schema, make it optional and defaulted
     // to false. Validation only occurs if the optional validateschema option has been specified.
     if (this.options.validateschema) {
@@ -868,7 +870,9 @@ export class PackageVersionCreate {
 
       const query =
         'SELECT Id, IsReleased FROM Package2Version ' +
-        `WHERE Package2Id = '${packageId}' AND MajorVersion = ${versionNumberSplit[0]} AND MinorVersion = ${versionNumberSplit[1]} AND PatchVersion = ${versionNumberSplit[2]}`;
+        `WHERE Package2Id = '${packageId ?? ''}' AND MajorVersion = ${versionNumberSplit[0]} AND MinorVersion = ${
+          versionNumberSplit[1]
+        } AND PatchVersion = ${versionNumberSplit[2]}`;
 
       let queriedAncestorId: string;
       const ancestorVersionResult = await this.connection.tooling.query<PackagingSObjects.Package2Version>(query);

src/utils/packageUtils.ts

@@ -11,7 +11,7 @@ import { pipeline as cbPipeline } from 'node:stream';
 import util, { promisify } from 'node:util';
 import { randomBytes } from 'node:crypto';
 import { Connection, Logger, Messages, ScratchOrgInfo, SfdcUrl, SfError, SfProject } from '@salesforce/core';
-import { isNumber, isString, Many, Nullable, Optional } from '@salesforce/ts-types';
+import { isNumber, isString, Many, Optional } from '@salesforce/ts-types';
 import type { SaveError } from '@jsforce/jsforce-node';
 import { Duration, ensureArray } from '@salesforce/kit';
 import globby from 'globby';
@@ -202,8 +202,8 @@ export async function getPackageVersionId(versionId: string, connection: Connect
   });
 }
 
-export function escapeInstallationKey(key?: string): Nullable<string> {
-  return key ? key.replace(/\\/g, '\\\\').replace(/'/g, "\\'") : null;
+export function escapeInstallationKey(key: string): string {
+  return key.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
 }
 
 /**

test/package/packageVersion.test.ts

@@ -110,6 +110,7 @@ describe('Package Version', () => {
 
   describe('create', () => {
     it('should include the package version create request ID', async () => {
+      // @ts-expect-error partial mock
       $$.SANDBOX.stub(PackageVersionCreate.prototype, 'createPackageVersion').resolves({
         Id: versionCreateRequestId,
       });