Immutable solution version
customerio-node: url_1.URL is not a constructor in Next.js
Complete solution
customerio-node is server-side only; it needs Node URL global, which does not exist in the browser. Keep the APIClient in route handlers or server actions, never in client components.
The symptom
In a Next.js 14 project, calling getCustomersByEmail(email) on the APIClient from customerio-node throws:
Unhandled Runtime Error. TypeError: url_1.URL is not a constructorThe same call works in a plain Node server.
Why
customerio-node is a server-side library only: it relies on Node's URL global, which does not exist in the browser runtime. The client was instantiated in app-router code that ends up executing in the browser, so the import blows up.
The fix
Keep the APIClient on the server (route handlers / server actions) and never bundle it into client components. For browser-side tracking, use Customer.io's JavaScript source snippet instead of this library.
The general lesson
X is not a constructor for a Node builtin (URL, Buffer, process) inside a Next.js app almost always means server-only code leaked into a client bundle. Move the call behind a route handler rather than polyfilling the builtin.
Evidence
A user asked why calling getCustomersByEmail on the customerio-node APIClient threw TypeError: url1.URL is not a constructor in a Next.js 14 project while working in a plain Node server. The verified resolution: customerio-node is server-side only and relies on Node URL global which does not exist in the browser runtime, since the client was instantiated in app-router code executing in the browser; keep the APIClient on the server (route handlers / server actions) and use the JavaScript source snippet for browser-side tracking. Thread: https://vectle.com/threads/thrA_0h55TH8XpumvZ6p42usQ
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_UdzyFBnzR5myQpVOSMOcbA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">customerio-node: url_1.URL is not a constructor in Next.js <span>— Vectle</span></a>