DOCSP-32118 require modules (#285)

* DOCSP-32118 require modules

* DOCSP-32118 require modules

* Self review

* Self review

* Review feedback

* Force build

* Review feedback

* Review feedback

* Review feedback

* Review feedback

* Self review

* Self review

* review feedback

* review feedback

Author: Dave Cuthbert

source/includes/scripting/fact-require-ems-modules.rst

@@ -0,0 +1,23 @@
+There are two packaging standards for Node.js modules.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Packaging Standard
+     - Works with require()
+
+   * - ``CommonJS`` (CJS)
+     -  Yes
+
+   * - ``ECMAScript Module`` (ES Module)
+     -  No
+
+You cannot ``require()`` an ES module in ``mongosh``. If you want to use
+functionality from an ES module, check to see if there is a CommonJS
+version that you can use instead. For more information, see:
+
+- `Node.js module documentation
+  <https://nodejs.org/api/esm.html#modules-ecmascript-modules>`__
+- `Installing older versions of npm packages
+  <https://docs.npmjs.com/cli/v9/commands/npm-install>`__
+

source/write-scripts/require-external-modules.txt

@@ -114,6 +114,8 @@ install the modules either:
 - Globally
 - In the ``node_modules`` directory in your current working directory.
 
+.. include:: /includes/scripting/fact-require-ems-modules.rst
+
 .. tip::
 
    You can require remote npm modules using this construction:

source/write-scripts/require-load-differences.txt

@@ -16,8 +16,8 @@ The ``require()`` and ``load()`` methods include files and modules in
 your scripts for added functionality. However, ``require()`` and
 ``load()`` differ in their behaviors and availability.
 
-Types of Scripts in ``mongosh``
--------------------------------
+Types of Scripts in mongosh
+---------------------------
 
 You can use the following types of scripts with ``mongosh``:
 
@@ -30,8 +30,8 @@ You can use the following types of scripts with ``mongosh``:
 - Node.js scripts, which are any scripts loaded with ``require()``,
   including npm packages. These scripts are always files.
 
-Availability of ``require()`` and ``load()``
---------------------------------------------
+Availability of require() and load()
+------------------------------------
 
 The ``require()`` and ``load()`` methods differ in availability
 depending on the type of script you are using.
@@ -40,8 +40,8 @@ depending on the type of script you are using.
 
 - In Node.js scripts, only ``require()`` is available.
 
-File Paths for ``require()`` and ``load()``
--------------------------------------------
+File Paths for require() and load()
+-----------------------------------
 
 The type of script determines how you specify file paths with
 ``require()`` or ``load()``.
@@ -73,7 +73,7 @@ The type of script determines how you specify file paths with
    To change the shell's working directory, use the :ref:`cd() 
    <mongosh-native-method-cd>` method in your script.
 
-Load External Code in a ``mongosh`` Script
+Load External Code in a mongosh Script
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can load external code in a ``mongosh`` script file, such as an npm
@@ -111,8 +111,13 @@ package or a separate ``mongosh`` script.
         const localRequire = require('date-fns').createRequire(__filename);  
         const fileExports = localRequire('./test-suite2.js'); }
 
-Access to the ``mongosh`` API
------------------------------
+require() Packaging Considerations
+----------------------------------
+
+.. include:: /includes/scripting/fact-require-ems-modules.rst
+
+Access to the mongosh API
+-------------------------
 
 - ``mongosh`` scripts can use the ``mongosh`` API.
 
@@ -134,4 +139,3 @@ available inside of Node.js scripts.
   Generally, you should not keep mongosh-specific code inside Node.js
   scripts.
 
-