Eliminate .NET version .js suffix in module import

Docs/dynamic-invoke.md

@@ -57,9 +57,8 @@ For examples of this scenario, see
     ```
 
    To load a specific version of .NET, append the target framework moniker to the module name.
-   A `.js` suffix is required when using ES modules, optional with CommonJS.
    ```JavaScript
-   import dotnet from 'node-api-dotnet/net6.0.js'
+   import dotnet from 'node-api-dotnet/net6.0'
    ```
    Currently the supported target frameworks are `net472`, `net6.0`, and `net8.0`.
 

Docs/node-module.md

@@ -76,9 +76,8 @@ For a minimal example of this scenario, see
     ```
 
    To load a specific version of .NET, append the target framework moniker to the module name.
-   A `.js` suffix is required when using ES modules, optional with CommonJS.
    ```JavaScript
-   import dotnet from 'node-api-dotnet/net6.0.js'
+   import dotnet from 'node-api-dotnet/net6.0'
    ```
    Currently the supported target frameworks are `net472`, `net6.0`, and `net8.0`.
 

src/node-api-dotnet/pack.js

@@ -135,7 +135,17 @@ function writePackageJson(packageStageDir, packageJson) {
   if (packageJson.dependencies && packageJson.dependencies['node-api-dotnet']) {
     packageJson.dependencies['node-api-dotnet'] = buildVersion;
   }
+
   delete packageJson.scripts;
+
+  // Generate package entry-points for each of the supported target framework monikers.
+  // https://nodejs.org/api/packages.html#package-entry-points
+  if (packageJson.exports) {
+    for (let tfm of targetFrameworks) {
+      packageJson.exports[`./${tfm}`] = `./${tfm}.js`;
+    }
+  }
+
   const stagedPackageJsonPath = path.join(packageStageDir, 'package.json');
   fs.writeFileSync(stagedPackageJsonPath, JSON.stringify(packageJson, undefined, '  '));
   console.log(stagedPackageJsonPath);
@@ -205,6 +215,9 @@ function generateTargetFrameworkScriptFiles(packageStageDir) {
 
 function generateTargetFrameworkScriptFile(filePath, tfm) {
   // Each generated entrypoint script uses `init.js` to request a specific target framework version.
+  // The exported module will be augmented with .NET namespaces from loaded assemblies.
+  // The module augmentation only works with CommonJS exports, because ESM exports are immutable.
+  // (ES modules can still import this CommonJS module.)
   const js = `const initialize = require('./init');
 module.exports = initialize(${tfm ? `'${tfm}'` : ''});
 `;

src/node-api-dotnet/package.json

@@ -2,11 +2,14 @@
   "name": "node-api-dotnet",
   "version": "0.1.0",
   "description": "Node-API bindings for .Net",
-  "main": "index.js",
   "license": "MIT",
   "author": "Microsoft",
   "scripts": {
   },
+  "type": "commonjs",
+  "exports": {
+    ".": "./index.js"
+  },
   "types": "./index.d.ts",
   "keywords": [
     "Node-API",

test/TestCases/napi-dotnet/ComplexTypes.cs

@@ -255,6 +255,6 @@ System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
 public class Equatable : IEquatable<Equatable>
 {
     public bool Equals(Equatable? other) => other != null;
-    public override bool Equals(object obj) => obj is Equatable;
+    public override bool Equals(object? obj) => obj is Equatable;
     public override int GetHashCode() => 1;
 }

test/TestCases/projects/js-esm/net472.js

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import assert from 'assert';
-import dotnet from 'node-api-dotnet/net472.js';
+import dotnet from 'node-api-dotnet/net472';
 
 import './bin/mscorlib.js';
 

test/TestCases/projects/js-esm/net6.0.js

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import assert from 'assert';
-import dotnet from 'node-api-dotnet/net6.0.js';
+import dotnet from 'node-api-dotnet/net6.0';
 
 import './bin/System.Runtime.js';
 import './bin/System.Console.js';

test/TestCases/projects/js-esm/net8.0.js

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import assert from 'assert';
-import dotnet from 'node-api-dotnet/net8.0.js';
+import dotnet from 'node-api-dotnet/net8.0';
 
 import './bin/System.Runtime.js';
 import './bin/System.Console.js';

test/TestCases/projects/ts-esm/net472.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import * as assert from 'assert';
-import dotnet from 'node-api-dotnet/net472.js';
+import dotnet from 'node-api-dotnet/net472';
 
 import './bin/mscorlib.js';
 

test/TestCases/projects/ts-esm/net6.0.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import * as assert from 'assert';
-import dotnet from 'node-api-dotnet/net6.0.js';
+import dotnet from 'node-api-dotnet/net6.0';
 
 import './bin/System.Runtime.js';
 import './bin/System.Console.js';

test/TestCases/projects/ts-esm/net8.0.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 
 import * as assert from 'assert';
-import dotnet from 'node-api-dotnet/net8.0.js';
+import dotnet from 'node-api-dotnet/net8.0';
 
 import './bin/System.Runtime.js';
 import './bin/System.Console.js';