feat!: migrate to ESM

BREAKING CHANGES: ESM and node 18 minimum

.eslintignore

@@ -0,0 +1 @@
+*.cjs/

.lintstagedrc.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  '**/*.{js,json,md}?(x)': () => 'npm run reformat',
+};

.mocharc.json

@@ -1,7 +1,8 @@
 {
-  "require": "ts-node/register,source-map-support/register",
+  "require": ["ts-node/register"],
   "watch-extensions": "ts",
   "recursive": true,
   "reporter": "spec",
-  "timeout": 20000
+  "timeout": 20000,
+  "node-option": ["loader=ts-node/esm"]
 }

bin/dev.cmd

@@ -1,3 +1,3 @@
 @echo off
 
-node "%~dp0\dev" %*
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

bin/dev.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ development: true, dir: import.meta.url });
+}
+
+await main();

bin/run.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ dir: import.meta.url });
+}
+
+await main();

package.json

@@ -1,34 +1,31 @@
 {
   "name": "@salesforce/plugin-packaging",
   "description": "SF plugin that support Salesforce Packaging Platform",
-  "version": "1.27.9",
-  "main": "lib/index.js",
+  "version": "2.0.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {
     "@oclif/core": "^3.14.1",
-    "@salesforce/core": "^6.4.0",
+    "@salesforce/core": "^6.4.1",
     "@salesforce/kit": "^3.0.15",
     "@salesforce/packaging": "^3.0.4",
-    "@salesforce/sf-plugins-core": "^5.0.8",
-    "chalk": "^4.1.2",
-    "tslib": "^2"
+    "@salesforce/sf-plugins-core": "^5.0.9",
+    "chalk": "^5.3.0"
   },
   "devDependencies": {
-    "@oclif/plugin-command-snapshot": "^4.0.16",
-    "@salesforce/cli-plugins-testkit": "^4.4.12",
+    "@oclif/plugin-command-snapshot": "^5.0.4",
+    "@salesforce/cli-plugins-testkit": "^5.1.1",
     "@salesforce/dev-scripts": "^8.1.2",
     "@salesforce/plugin-command-reference": "^3.0.51",
-    "@swc/core": "1.3.100",
     "eslint-plugin-sf-plugin": "^1.16.15",
-    "oclif": "^4",
+    "oclif": "^4.0.4",
     "shx": "0.3.4",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3"
   },
   "config": {},
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "files": [
     "/lib",
@@ -41,11 +38,11 @@
   "keywords": [
     "force",
     "salesforce",
-    "sfdx",
-    "sf",
     "salesforcedx",
-    "sfdx-plugin",
-    "sf-plugin"
+    "sf",
+    "sf-plugin",
+    "sfdx",
+    "sfdx-plugin"
   ],
   "license": "BSD-3-Clause",
   "oclif": {
@@ -108,7 +105,9 @@
           }
         }
       }
-    }
+    },
+    "flexibleTaxonomy": true,
+    "topicSeparator": " "
   },
   "repository": "salesforcecli/plugin-packaging",
   "scripts": {
@@ -210,7 +209,7 @@
       "output": []
     },
     "test:command-reference": {
-      "command": "\"./bin/dev\" commandreference:generate --erroronwarnings",
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" commandreference:generate --erroronwarnings",
       "files": [
         "src/**/*.ts",
         "messages/**",
@@ -221,7 +220,7 @@
       ]
     },
     "test:deprecation-policy": {
-      "command": "\"./bin/dev\" snapshot:compare",
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" snapshot:compare",
       "files": [
         "src/**/*.ts"
       ],
@@ -231,7 +230,7 @@
       ]
     },
     "test:json-schema": {
-      "command": "\"./bin/dev\" schema:compare",
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" schema:compare",
       "files": [
         "src/**/*.ts",
         "schemas"
@@ -247,5 +246,7 @@
       ],
       "output": []
     }
-  }
+  },
+  "exports": "./lib/index.js",
+  "type": "module"
 }

src/commands/package/convert.ts

@@ -16,9 +16,9 @@ import {
   PackagingSObjects,
 } from '@salesforce/packaging';
 import { camelCaseToTitleCase, Duration } from '@salesforce/kit';
-import { requiredHubFlag } from '../../utils/hubFlag';
+import { requiredHubFlag } from '../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_convert');
 const pvcMessages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_create');
 

src/commands/package/create.ts

@@ -8,9 +8,9 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { Package, PackageCreateOptions, PackageType } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../utils/hubFlag';
+import { requiredHubFlag } from '../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_create');
 
 export type PackageCreate = { Id: string };

src/commands/package/delete.ts

@@ -8,9 +8,9 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { Package, PackageSaveResult } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../utils/hubFlag';
+import { requiredHubFlag } from '../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_delete');
 
 export class PackageDeleteCommand extends SfCommand<PackageSaveResult> {

src/commands/package/install.ts

@@ -21,11 +21,11 @@ import {
   PackagingSObjects,
   SubscriberPackageVersion,
 } from '@salesforce/packaging';
-import { Report } from './install/report';
+import { Report } from './install/report.js';
 
 export type PackageInstallRequest = PackagingSObjects.PackageInstallRequest;
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_install');
 
 // maps of command flag values to PackageInstallRequest values

src/commands/package/install/report.ts

@@ -17,7 +17,7 @@ import { PackagingSObjects, SubscriberPackageVersion } from '@salesforce/packagi
 
 export type PackageInstallRequest = PackagingSObjects.PackageInstallRequest;
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_install_report');
 const installMsgs = Messages.loadMessages('@salesforce/plugin-packaging', 'package_install');
 

src/commands/package/installed/list.ts

@@ -15,7 +15,7 @@ import {
 import { ux } from '@oclif/core';
 import { SubscriberPackageVersion } from '@salesforce/packaging';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_installed_list');
 
 export type PackageInstalledListResult = {

src/commands/package/list.ts

@@ -8,10 +8,10 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { Package, PackagingSObjects } from '@salesforce/packaging';
-import * as chalk from 'chalk';
-import { requiredHubFlag } from '../../utils/hubFlag';
+import chalk from 'chalk';
+import { requiredHubFlag } from '../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_list');
 
 export type Package2Result = Partial<

src/commands/package/uninstall.ts

@@ -18,7 +18,7 @@ import { Duration } from '@salesforce/kit';
 
 export type UninstallResult = PackagingSObjects.SubscriberPackageVersionUninstallRequest;
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_uninstall');
 
 export class PackageUninstallCommand extends SfCommand<UninstallResult> {

src/commands/package/uninstall/report.ts

@@ -15,7 +15,7 @@ import {
 import { Messages } from '@salesforce/core';
 import { PackagingSObjects, SubscriberPackageVersion } from '@salesforce/packaging';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_uninstall_report');
 
 export class PackageUninstallReportCommand extends SfCommand<PackagingSObjects.SubscriberPackageVersionUninstallRequest> {

src/commands/package/update.ts

@@ -8,9 +8,9 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { Package, PackageSaveResult } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../utils/hubFlag';
+import { requiredHubFlag } from '../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_update');
 const packageCreate = Messages.loadMessages('@salesforce/plugin-packaging', 'package_create');
 

src/commands/package/version/create.ts

@@ -5,7 +5,7 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 
-import * as os from 'node:os';
+import os from 'node:os';
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { camelCaseToTitleCase, Duration } from '@salesforce/kit';
 import { Lifecycle, Messages } from '@salesforce/core';
@@ -17,10 +17,10 @@ import {
   PackageVersionEvents,
   PackagingSObjects,
 } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
 import Package2VersionStatus = PackagingSObjects.Package2VersionStatus;
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_create');
 
 export type PackageVersionCommandResult = Partial<PackageVersionCreateRequestResult>;

src/commands/package/version/create/list.ts

@@ -8,10 +8,10 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Connection, Messages } from '@salesforce/core';
 import { PackageVersion, PackageVersionCreateRequestResult, getPackageVersionNumber } from '@salesforce/packaging';
-import * as chalk from 'chalk';
-import { requiredHubFlag } from '../../../../utils/hubFlag';
+import chalk from 'chalk';
+import { requiredHubFlag } from '../../../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_create_list');
 const packaging = Messages.loadMessages('@salesforce/plugin-packaging', 'packaging');
 

src/commands/package/version/create/report.ts

@@ -7,13 +7,13 @@
 
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages, Org } from '@salesforce/core';
-import * as pkgUtils from '@salesforce/packaging';
+import pkgUtils from '@salesforce/packaging';
 import { PackageVersion, PackageVersionCreateRequestResult } from '@salesforce/packaging';
-import * as chalk from 'chalk';
+import chalk from 'chalk';
 import { camelCaseToTitleCase } from '@salesforce/kit';
-import { requiredHubFlag } from '../../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_create_report');
 const pvclMessages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_create_list');
 const pvlMessages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_list');

src/commands/package/version/delete.ts

@@ -8,9 +8,9 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { PackageSaveResult, PackageVersion } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_delete');
 
 export class PackageVersionDeleteCommand extends SfCommand<PackageSaveResult> {

src/commands/package/version/displayancestry.ts

@@ -8,10 +8,10 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { Package, PackageAncestryNodeData } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
 
 // Import i18n messages
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_displayancestry');
 
 export type DisplayAncestryCommandResult = PackageAncestryNodeData | string | void;

src/commands/package/version/list.ts

@@ -15,9 +15,9 @@ import {
   Package,
   PackageVersionListResult,
 } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_list');
 const packaging = Messages.loadMessages('@salesforce/plugin-packaging', 'packaging');
 

src/commands/package/version/promote.ts

@@ -8,9 +8,9 @@
 import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
 import { Messages, SfError } from '@salesforce/core';
 import { PackageSaveResult, PackageVersion } from '@salesforce/packaging';
-import { requiredHubFlag } from '../../../utils/hubFlag';
+import { requiredHubFlag } from '../../../utils/hubFlag.js';
 
-Messages.importMessagesDirectory(__dirname);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-packaging', 'package_version_promote');
 
 export class PackageVersionPromoteCommand extends SfCommand<PackageSaveResult> {