Skip to content

fix: backward-compat for ESM etherpad#99

Merged
SamTV12345 merged 1 commit into
mainfrom
fix/esm-compat
May 25, 2026
Merged

fix: backward-compat for ESM etherpad#99
SamTV12345 merged 1 commit into
mainfrom
fix/esm-compat

Conversation

@SamTV12345
Copy link
Copy Markdown
Member

This PR makes the plugin backward-compatible with the upcoming ESM etherpad branch (ether/etherpad#7605).

Change: Remove trailing slash from require("ep_etherpad-lite/node/eejs/")require("ep_etherpad-lite/node/eejs")

The trailing-slash form breaks under Node's strict ESM exports map resolution. This change is backward-compatible with the current CJS etherpad release.

- Drop trailing slash on ep_etherpad-lite/node/eejs/ require

Backward-compatible with current CJS etherpad release; also
compatible with the upcoming ESM etherpad branch which has stricter
exports map resolution.
@qodo-code-review
Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

@qodo-free-for-open-source-projects
Copy link
Copy Markdown

Review Summary by Qodo

Remove trailing slash from eejs require path

🐞 Bug fix

Grey Divider

Walkthroughs

Description
• Remove trailing slash from eejs require path
• Ensures compatibility with ESM etherpad exports
• Maintains backward compatibility with current CJS
• Bump version to 0.1.62
Diagram
flowchart LR
  A["require with trailing slash"] -- "remove slash" --> B["require without slash"]
  B -- "compatible with" --> C["ESM etherpad"]
  B -- "compatible with" --> D["CJS etherpad"]

Loading

File Changes

1. index.js 🐞 Bug fix +1/-1

Remove trailing slash from eejs require

• Remove trailing slash from require('ep_etherpad-lite/node/eejs/') path
• Change to require('ep_etherpad-lite/node/eejs') for strict ESM exports resolution
• Maintains backward compatibility with current CJS etherpad release

index.js


2. package.json ⚙️ Configuration changes +1/-1

Bump version to 0.1.62

• Increment version from 0.1.61 to 0.1.62

package.json


Grey Divider

Qodo Logo

@qodo-free-for-open-source-projects
Copy link
Copy Markdown

qodo-free-for-open-source-projects Bot commented May 25, 2026

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (1)

Grey Divider


Action required

1. ESM eejs require untested 📘 Rule violation ☼ Reliability
Description
This PR fixes a runtime module resolution bug by changing the require() path, but it does not add
or update any automated regression test to cover the failing scenario. Without a test, the same ESM
compatibility break could reoccur unnoticed in future changes.
Code

index.js[5]

Evidence
PR Compliance ID 1 requires a regression test for bug fixes. The bug fix is the updated require()
in index.js, and there are no accompanying test additions/updates in the PR diff to validate the
ESM compatibility behavior.

AGENTS.md: Every Bug Fix Must Include a Regression Test
index.js[3-6]
package.json[1-34]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The PR fixes an ESM-related runtime break (changing the `require('ep_etherpad-lite/node/eejs/')` path), but no regression test was added/updated to ensure the plugin loads and works under the relevant environment.

## Issue Context
Per compliance, bug fixes must include at least one regression test that would fail before the fix and pass after. For this change, a good regression test is a plugin-load/route smoke test that fails if the plugin cannot be required/initialized due to module resolution rules.

## Fix Focus Areas
- static/tests/backend/specs/ (add a new spec file)
- static/tests/frontend-new/specs/smoke.spec.ts[8-13] (optional: extend to cover `/list/...` behavior)
- index.js[5-5]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Qodo Logo

Comment thread index.js
const {template} = require('ep_plugin_helpers');

const eejs = require('ep_etherpad-lite/node/eejs/');
const eejs = require('ep_etherpad-lite/node/eejs');
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Action required

1. Esm eejs require untested 📘 Rule violation ☼ Reliability

This PR fixes a runtime module resolution bug by changing the require() path, but it does not add
or update any automated regression test to cover the failing scenario. Without a test, the same ESM
compatibility break could reoccur unnoticed in future changes.
Agent Prompt
## Issue description
The PR fixes an ESM-related runtime break (changing the `require('ep_etherpad-lite/node/eejs/')` path), but no regression test was added/updated to ensure the plugin loads and works under the relevant environment.

## Issue Context
Per compliance, bug fixes must include at least one regression test that would fail before the fix and pass after. For this change, a good regression test is a plugin-load/route smoke test that fails if the plugin cannot be required/initialized due to module resolution rules.

## Fix Focus Areas
- static/tests/backend/specs/ (add a new spec file)
- static/tests/frontend-new/specs/smoke.spec.ts[8-13] (optional: extend to cover `/list/...` behavior)
- index.js[5-5]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

@SamTV12345 SamTV12345 merged commit 0e0e029 into main May 25, 2026
3 checks passed
@SamTV12345 SamTV12345 deleted the fix/esm-compat branch May 25, 2026 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant