feat(pkg): add exports map for ep_etherpad-lite

Routes CJS plugins' require() calls to dist-cjs/*.cjs twins while
keeping ESM consumers on dist/*.mjs (tsdown emits .mjs for ESM). The
trailing-.js wildcard handles plugins that wrote require(...'.js')
with an explicit extension. tests/backend has only an import
condition because CJS build excludes it (top-level await).

Also fixes Settings.ts getEpVersion() to use a static JSON import
instead of a build-path-relative requireFromHere() call, which broke
when resolved from dist-cjs/node/utils/. Test file updated: split
cjsSubpaths into resolvable vs loadable sets since DB modules
transitively depend on ueberdb2 (ESM-only, no require condition).

Author: SamTV12345

src/node/utils/Settings.ts

@@ -39,12 +39,10 @@ import jsonminify from 'jsonminify';
 import log4js from 'log4js';
 import randomString from './randomstring.js';
 import {createHash} from 'node:crypto';
-import { createRequire } from 'node:module';
 const suppressDisableMsg = ' -- To suppress these warning messages change ' +
     'suppressErrorsInPadText to true in your settings.json\n';
 import _ from 'underscore';
-
-const requireFromHere = createRequire(import.meta.url);
+import pkg from '../../package.json' with { type: 'json' };
 
 const logger = log4js.getLogger('settings');
 
@@ -926,7 +924,7 @@ export const exportAvailable = () => sofficeAvailable();
 
 
 // Return etherpad version from package.json
-export const getEpVersion = () => requireFromHere('../../package.json').version;
+export const getEpVersion = () => pkg.version;
 
 
 

src/package.json

@@ -9,6 +9,41 @@
     "collaborative",
     "editor"
   ],
+  "main": "./dist-cjs/node/server.cjs",
+  "module": "./dist/node/server.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/node/server.mjs",
+      "require": "./dist-cjs/node/server.cjs"
+    },
+    "./node/eejs": {
+      "import": "./dist/node/eejs/index.mjs",
+      "require": "./dist-cjs/node/eejs/index.cjs"
+    },
+    "./node/*": {
+      "import": "./dist/node/*.mjs",
+      "require": "./dist-cjs/node/*.cjs"
+    },
+    "./node/*.js": {
+      "import": "./dist/node/*.mjs",
+      "require": "./dist-cjs/node/*.cjs"
+    },
+    "./static/js/*": {
+      "import": "./dist/static/js/*.mjs",
+      "require": "./dist-cjs/static/js/*.cjs"
+    },
+    "./static/js/*.js": {
+      "import": "./dist/static/js/*.mjs",
+      "require": "./dist-cjs/static/js/*.cjs"
+    },
+    "./tests/backend/*": {
+      "import": "./dist/tests/backend/*.mjs"
+    },
+    "./tests/backend/*.js": {
+      "import": "./dist/tests/backend/*.mjs"
+    },
+    "./package.json": "./package.json"
+  },
   "author": "Etherpad Foundation",
   "contributors": [
     {

src/tests/backend/specs/exports_map.ts

@@ -3,13 +3,21 @@ import { createRequire } from 'node:module';
 
 const require = createRequire(import.meta.url);
 
-const cjsSubpaths = [
+// All CJS subpaths must resolve to a .cjs file.
+const cjsResolvableSubpaths = [
   'ep_etherpad-lite/node/eejs',
   'ep_etherpad-lite/node/db/PadManager',
   'ep_etherpad-lite/node/db/API.js',
   'ep_etherpad-lite/node/db/AuthorManager',
   'ep_etherpad-lite/static/js/pad_utils',
-  'ep_etherpad-lite/tests/backend/common',
+];
+
+// Only these subpaths can be synchronously require()-loaded: their transitive
+// dependency graph is CJS-compatible. DB modules (PadManager, API, AuthorManager)
+// transitively import ueberdb2 which is ESM-only (no "require" export condition).
+const cjsLoadableSubpaths = [
+  'ep_etherpad-lite/node/eejs',
+  'ep_etherpad-lite/static/js/pad_utils',
 ];
 
 const esmSubpaths = [
@@ -21,12 +29,14 @@ const esmSubpaths = [
 
 describe('ep_etherpad-lite exports map', () => {
   describe('require() condition (CJS plugins)', () => {
-    for (const spec of cjsSubpaths) {
+    for (const spec of cjsResolvableSubpaths) {
       test(`require('${spec}') resolves`, () => {
         const resolved = require.resolve(spec);
         expect(resolved).toMatch(/\.cjs$/);
       });
+    }
 
+    for (const spec of cjsLoadableSubpaths) {
       test(`require('${spec}') loads a module`, () => {
         const mod = require(spec);
         expect(mod).toBeTruthy();