ERR_REQUIRE_ESM

[Tsopic]

⏺ PreToolUse:TodoWrite [tdd-guard] failed with non-blocking status code 1: node:internal/modules/cjs/loader:1285
      throw new ERR_REQUIRE_ESM(filename, true);
      ^

  Error [ERR_REQUIRE_ESM]: require() of ES Module 
  /Users/tsopic/.nvm/versions/node/v20.18.1/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs not 
  supported.
  Instead change the require of 
  /Users/tsopic/.nvm/versions/node/v20.18.1/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs to a dynamic 
  import() which is available in all CommonJS modules.
      at Object.<anonymous> 
  (/Users/tsopic/.nvm/versions/node/v20.18.1/lib/node_modules/tdd-guard/dist/validation/models/ClaudeCodeSdk.js:5:23) {
    code: 'ERR_REQUIRE_ESM'
  }

  Node.js v20.18.1

What should i do with this error?

[nizos]

Hi @Tsopic,

Thanks for reporting this!

Turns out the reporter dependencies were out of sync. The issue wasn't obvious before due to version overshadowing. I've pushed updates that should fix it.

Just update whichever reporter you're using:

• tdd-guard-vitest@0.1.5
• tdd-guard-jest@0.1.2

That should get things working again. Let me know if you run into any other issues!

[azgul]

I'm having a similar issue. With the tdd-guard-go reporter. See below. Am I holding it wrong?

$ npm install -g tdd-guard

changed 12 packages in 2s

6 packages are looking for funding
  run `npm fund` for details

$ go install github.com/nizos/tdd-guard/reporters/go/cmd/tdd-guard-go@latest
go: downloading github.com/nizos/tdd-guard v1.0.1
go: downloading github.com/nizos/tdd-guard/reporters/go v0.2.1
go: github.com/nizos/tdd-guard/reporters/go@v0.2.1 requires go >= 1.24; switching to go1.24.7
go: downloading go1.24.7 (darwin/arm64)

$ tdd-guard
node:internal/modules/cjs/loader:1089
    throw new ERR_REQUIRE_ESM(filename, true);
    ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs not supported.
Instead change the require of /Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/validation/models/ClaudeCodeSdk.js:5:23)
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/providers/ModelClientProvider.js:7:25)
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/cli/tdd-guard.js:10:31) {
  code: 'ERR_REQUIRE_ESM'
}

Node.js v20.5.0

Actually it appears to happen even without installing tdd-guard-go.

[Tsopic]

I'm having a similar issue. With the tdd-guard-go reporter. See below. Am I holding it wrong?

$ npm install -g tdd-guard

changed 12 packages in 2s

6 packages are looking for funding
  run `npm fund` for details

$ go install github.com/nizos/tdd-guard/reporters/go/cmd/tdd-guard-go@latest
go: downloading github.com/nizos/tdd-guard v1.0.1
go: downloading github.com/nizos/tdd-guard/reporters/go v0.2.1
go: github.com/nizos/tdd-guard/reporters/go@v0.2.1 requires go >= 1.24; switching to go1.24.7
go: downloading go1.24.7 (darwin/arm64)

$ tdd-guard
node:internal/modules/cjs/loader:1089
    throw new ERR_REQUIRE_ESM(filename, true);
    ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs not supported.
Instead change the require of /Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/node_modules/@anthropic-ai/claude-code/sdk.mjs to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/validation/models/ClaudeCodeSdk.js:5:23)
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/providers/ModelClientProvider.js:7:25)
    at Object.<anonymous> (/Users/azgul/.nvm/versions/node/v20.5.0/lib/node_modules/tdd-guard/dist/cli/tdd-guard.js:10:31) {
  code: 'ERR_REQUIRE_ESM'
}

Node.js v20.5.0

I belive mine was also with either GO or Python reporter

[nizos]

Hi @azgul!

Thanks for the additional information. I was able to reproduce it using Node v20.5.0:

❯ node --version
v20.5.0

❯ npm install -g tdd-guard

added 12 packages in 3s

6 packages are looking for funding
  run `npm fund` for details

❯ tdd-guard
node:internal/modules/cjs/loader:1089
    throw new ERR_REQUIRE_ESM(filename, true);
    ^

This seems to be an ESM/CommonJS compatibility that was addressed in later Node versions:

❯ node --version
v20.19.4

❯ npm i -g tdd-guard

added 12 packages in 2s

6 packages are looking for funding
  run `npm fund` for details

❯ tdd-guard

A workaround is to update to Node version 20.19+ or newer.

And thank you @Tsopic as well for the additional information.
I will look into adding compatibility for older versions.

[azgul]

A workaround is to update to Node version 20.19+ or newer.

Thanks. No longer errors on 22.19.0.

Readme says tdd-guard requires 18+ FWIW: https://github.com/nizos/tdd-guard/blame/main/README.md#L34