wstp-node 0.4.4 → 0.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wstp-node",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Native Node.js addon for Wolfram/Mathematica WSTP — kernel sessions with evaluation queue, streaming Print/messages, Dialog subsessions, and side-channel WstpReader",
   "main": "build/Release/wstp.node",
   "types": "index.d.ts",
@@ -30,6 +30,7 @@
     "src/addon.cc",
     "scripts/wstp_dir.js",
     "scripts/install.js",
+    "scripts/diagnose-windows.ps1",
     "build.sh",
     "binding.gyp",
     "index.d.ts",

package/scripts/diagnose-windows.ps1

@@ -0,0 +1,58 @@
+# diagnose-windows.ps1
+# Run this in PowerShell to find the WSTP DeveloperKit on your Windows machine.
+# It searches for the two files that wstp-node needs:
+#   wstp.h         (C header)
+#   wstp64i4s.lib  (static import library)
+#
+# Usage:
+#   powershell -ExecutionPolicy Bypass -File diagnose-windows.ps1
+
+Write-Host "`n=== Searching for WSTP DeveloperKit files ===`n" -ForegroundColor Cyan
+
+$files = @("wstp.h", "wstp64i4s.lib")
+$searchRoots = @(
+    "C:\Program Files\Wolfram Research",
+    "C:\Program Files (x86)\Wolfram Research",
+    "$env:LOCALAPPDATA\Programs\Wolfram Research"
+)
+
+$found = @{}
+
+foreach ($root in $searchRoots) {
+    if (-not (Test-Path $root)) { continue }
+    Write-Host "Searching under: $root" -ForegroundColor Gray
+    foreach ($file in $files) {
+        $results = Get-ChildItem -Path $root -Filter $file -Recurse -ErrorAction SilentlyContinue
+        foreach ($r in $results) {
+            Write-Host "  FOUND $file at: $($r.FullName)" -ForegroundColor Green
+            $found[$file] = $r.DirectoryName
+        }
+    }
+}
+
+Write-Host ""
+
+if ($found.Count -eq 0) {
+    Write-Host "Neither wstp.h nor wstp64i4s.lib found." -ForegroundColor Red
+    Write-Host "Make sure Wolfram Engine or Mathematica is installed."
+    exit 1
+}
+
+# If both are in the same directory, suggest WSTP_DIR
+$dirs = $found.Values | Sort-Object -Unique
+if ($dirs.Count -eq 1) {
+    $dir = $dirs[0]
+    Write-Host "Both files are in:" -ForegroundColor Cyan
+    Write-Host "  $dir" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "Run this before npm install:" -ForegroundColor Cyan
+    Write-Host "  `$env:WSTP_DIR = `"$dir`"" -ForegroundColor Yellow
+    Write-Host "  npm install" -ForegroundColor Yellow
+} else {
+    Write-Host "Files found in different directories — use the directory containing both:" -ForegroundColor Yellow
+    foreach ($kv in $found.GetEnumerator()) {
+        Write-Host "  $($kv.Key) => $($kv.Value)"
+    }
+    Write-Host ""
+    Write-Host "Set WSTP_DIR to the folder containing both files, then run npm install."
+}

package/scripts/wstp_dir.js

@@ -62,7 +62,11 @@ function resolve () {
       if (!fs.existsSync(path.join(wstp, 'wstp.h')) &&
           !fs.existsSync(path.join(wstp, 'wstp64i4s.lib'))) {
         process.stderr.write(
-          `wstp_dir: WSTP DeveloperKit not found at expected path:\n  ${wstp}\n`
+          `wstp_dir: found version "${versions[0]}" but WSTP DeveloperKit missing.\n` +
+          `  Expected these files inside:\n` +
+          `    ${wstp}\n` +
+          `      wstp.h          (C header)\n` +
+          `      wstp64i4s.lib   (static import library)\n`
         );
         continue;
       }
@@ -71,10 +75,15 @@ function resolve () {
 
     throw new Error(
       `WSTP DeveloperKit not found.\n` +
-      `Tried under "${base}" for: ${products.join(', ')}\n\n` +
-      `Set WSTP_DIR to your CompilerAdditions folder, e.g.:\n` +
+      `Searched under "${base}" for: ${products.join(', ')}\n\n` +
+      `The build needs these two files:\n` +
+      `  wstp.h          (C header)\n` +
+      `  wstp64i4s.lib   (static import library)\n\n` +
+      `Run the diagnostic script to find them:\n` +
+      `  powershell -ExecutionPolicy Bypass -File scripts\\diagnose-windows.ps1\n\n` +
+      `Then set WSTP_DIR to the folder containing both files and retry:\n` +
       `  set WSTP_DIR=C:\\Program Files\\Wolfram Research\\Wolfram Engine\\14.2\\SystemFiles\\Links\\WSTP\\DeveloperKit\\Windows-x86-64\\CompilerAdditions\n` +
-      `then run npm install again.`
+      `  npm install`
     );
   }