node-api-dotnet 0.4.27 → 0.4.33

package/index.d.ts

@@ -6,6 +6,17 @@
 // This explicit module declaration enables module members to be merged with imported namespaces.
 declare module 'node-api-dotnet' {
 
+/**
+ * Gets the current .NET runtime version, for example "8.0.1".
+ */
+export const runtimeVersion: string;
+
+/**
+ * Gets the framework monikier corresponding to the current .NET runtime version,
+ * for example "net8.0" or "net472".
+ */
+export const frameworkMoniker: string;
+
 /**
  * Loads a .NET assembly that was built to be a Node API module, using static binding to
  * the APIs the module specifically exports to JS.

package/index.js

@@ -1,2 +1,2 @@
 const initialize = require('./init');
-module.exports = initialize('net6.0');
+module.exports = initialize();

package/init.js

@@ -16,18 +16,36 @@ const ridPlatform =
 const ridArch = process.arch === 'ia32' ? 'x86' : process.arch;
 const rid = `${ridPlatform}-${ridArch}`;
 
+const defaultTargetFramework = 'net8.0';
+
+/**
+ * The loaded instance of the .NET Runtime. Only one instance/version may be loaded in the process.
+ */
+let dotnet = undefined;
+
 /**
  * Initializes the Node API .NET host.
- * @param {string} targetFramework Minimum requested .NET version. Must be one of the target
+ * @param {string?} targetFramework Minimum requested .NET version. Must be one of the target
  * framework monikers supported by the Node API .NET package. The actual loaded version of .NET
  * may be higher, if the requested version is not installed.
  * @returns {import('./index')} The Node API .NET host.
  */
 function initialize(targetFramework) {
+  if (!targetFramework) {
+    // Some version was already loaded and no specific version was requested.
+    // Return the already-loaded version.
+    if (dotnet) {
+      return dotnet;
+    }
+
+    targetFramework = defaultTargetFramework;
+  }
+
   const assemblyName = 'Microsoft.JavaScript.NodeApi';
   const nativeHostPath = __dirname + `/${rid}/${assemblyName}.node`;
   const managedHostPath = __dirname + `/${targetFramework}/${assemblyName}.DotNetHost.dll`
 
   const nativeHost = require(nativeHostPath);
-  return nativeHost.initialize(targetFramework, managedHostPath, require);
+  dotnet = nativeHost.initialize(targetFramework, managedHostPath, require);
+  return dotnet;
 }

package/net472.d.ts

@@ -0,0 +1,2 @@
+import './index';
+export * from 'node-api-dotnet';

package/net6.0.d.ts

@@ -0,0 +1,2 @@
+import './index';
+export * from 'node-api-dotnet';

package/net8.0.d.ts

@@ -0,0 +1,2 @@
+import './index';
+export * from 'node-api-dotnet';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-api-dotnet",
-  "version": "0.4.27",
+  "version": "0.4.33",
   "description": "Node-API bindings for .Net",
   "main": "index.js",
   "license": "MIT",