ENOENT when using @datocms/cma-client-node on a Windows machine

[vinixhenri]

Getting the error below once the require of the @datocms/cma-client-node is added with:
const { buildClient } = require('@datocms/cma-client-node')
This only happens in a Windows machine (tried with PowerShell and git bash, both get the same error).
On a Mac computer it works fine.

{
  "errorMessage": "ENOENT: no such file or directory, lstat 'C:\\Users\\user\\Desktop\\workspace\\project\\serverless\\undefined'",
  "errorType": "Error",
  "stackTrace": [
    "Error: ENOENT: no such file or directory, lstat 'C:\\Users\\user\\Desktop\\workspace\\project\\serverless\\undefined'",
    "at Object.realpathSync (node:fs:2787:29)",
    "at _getTmpDirSync (C:\\Users\\user\\Desktop\\workspace\\project\\serverless\\node_modules\\tmp\\lib\\tmp.js:728:13)",
    "at Object.get [as tmpdir] (C:\\Users\\user\\Desktop\\workspace\\project\\serverless\\node_modules\\tmp\\lib\\tmp.js:829:12)",
    "at Object.\u003Canonymous\u003E (C:\\Users\\user\\Desktop\\workspace\\project\\serverless\\node_modules\\tmp-promise\\index.js:48:29)",
    "at Module._compile (node:internal/modules/cjs/loader:1730:14)",
    "at Object..js (node:internal/modules/cjs/loader:1895:10)",
    "at Module.load (node:internal/modules/cjs/loader:1465:32)",
    "at Function._load (node:internal/modules/cjs/loader:1282:12)",
    "at TracingChannel.traceSync (node:diagnostics_channel:322:14)"
  ]
}

PC Info:

System:
OS: Windows 11 10.0.26100
CPU: (8) x64 11th Gen Intel(R) Core(TM) i7-1165G7 @ 2.80GHz
Memory: 3.07 GB / 15.73 GB
Binaries:
Node: 22.15.0 - ~.nvm\versions\node\v22.15.0\bin\node.EXE
Yarn: 1.22.22 - ~.nvm\versions\node\v22.15.0\bin\yarn.CMD
npm: 10.9.2 - ~.nvm\versions\node\v22.15.0\bin\npm.CMD

Reproduction

Basically install it and require of package already gets you this error on a Windows machine, but in my case it's setup on a serverless with serverless-offline + express.

@datocms/cma-client-node: 5.1.23

[arcataroger]

@vinixhenri,

Sorry, could you maybe please provide a reproduction repo where this is happening?

We don't have real Windows machines unfortunately, but this seems to work for me in a Windows 11 VM:

It's able to run without issue and makes an attempted network call, which 401s as expected (because we didn't provide real auth).

Could this be an issue with the specific framework environment you're running it in...? By "serverless", do you mean https://www.serverless.com/ (as opposed to a raw lambda or a Cloudflare Worker, etc.?) What does the full setup look like? If you could please share a reproduction repo where this is failing, we can take a look in there?

And does this sort of setup normally run from a Windows host in production, or is this only an issue with your developer environment? Most of our customers end up deploying on Linux targets so that's what we end up testing against, but if there's a specific Windows-based serverless host where this is failing, please let us know...

[arcataroger]

I get the same successful result with Powershell (just in case it was a shell path escaping issue, which it doesn't seem to be...):

[viniciushvsilva]

Apparently this bug only occurs when using together with serverless offline (https://www.serverless.com/ https://www.serverless.com/plugins/serverless-offline), as this is used by our team to develop locally.
Perhaps would result in the same error when using serverless deployed on a Windows machine.
I'll create a repo to reproduce this issue as soon as I can and share with you.

[viniciushvsilva]

I was able to create the following repo + reproduction so you can verify:

https://github.com/vinixhenri/bug-repro-datocms-cma-client-node/actions/runs/18793195505/job/53628023470

It seems when this package is used along with serverless offline it crashes.
Also, the error comes from the tmp package used by cma-client-node (tmp-promise -> tmp).

If you want to reproduce the issue, you can basically clone the https://github.com/vinixhenri/bug-repro-datocms-cma-client-node repo and run npm run offline on a Windows machine.

PS: If I remove/comment the const { buildClient } = require('@datocms/cma-client-node') line, then it works

[stefanoverna]

Did you try @datocms/cma-client package instead of @datocms/cma-client-node?

The only difference between the two, is in the methods available to upload files and create assets, the node version has specific helpers optimized for a regular node environment.

Serverless environments often support JS (the language) but are not 100% node-compatible. The same applies for Cloudflare workers or Vercel edge functions.

More info: https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients#how-to-install-the-client