d

Author: stopsopa

esbuild-node.js

@@ -1,4 +1,25 @@
-// used by esbuild-node.sh
+// This script bundles files matching *.node.[js|cjs|mjs] using esbuild.
+// The list of files to process is passed as a text file path in the first argument.
+//
+// WHY THIS SCRIPT EXISTS:
+// Raw esbuild typically outputs .js files. However, for Node.js scripts, 
+// the extension (.cjs or .mjs) is critical for correct module resolution.
+//
+// Example Transformation:
+//   Input:   ./pages/bash/xx/xx.node.cjs
+//   Esbuild: outputs ./pages/bash/xx/xx.node.bundled.gitignored.js
+//   Script:  copies .js to ./pages/bash/xx/xx.node.bundled.gitignored.cjs
+//            (Note: This results in TWO files: the .js bundle and the .cjs copy)
+//
+// Without this script, Node.js might fail to run the bundle if it misinterprets 
+// the module type (ESM vs CJS). This script keeps the target extension in sync.
+//
+// Usage:
+//   node esbuild-node.js var/esbuild.txt
+//   node esbuild-node.js var/esbuild.txt --watch
+//
+// Typically called by: /bin/bash esbuild-node.sh [watch]
+
 
 import * as esbuild from "esbuild";
 

xx.cjs

@@ -32,6 +32,9 @@ cat <<EEE
   server:
     http://\${LOCAL_HOSTS}:\${NODE_API_PORT}
 
+  Warning: 
+      Generally this project uses pnpm
+
 EEE
 
       `,