Zod v4 causes "JavaScript execution ran out of memory (64 MB)" on push
🪲Bug Report
After migrating from Zod v3 to Zod v4, npx convex dev fails with:
JavaScript execution ran out of memory (maximum memory usage: 64 MB)
Bundle analysis (via --debug-bundle-path):
- Isolate: 399 files, 6.0 MB source code
- Node: 121 files, 19.1 MB source code
- fullConfig.json: 44 MB total
The isolate bundle is well under the 32 MiB code limit. The issue
is runtime memory during module initialization, not bundle size.
Root cause: Zod v4 core is ~700KB in the isolate (vs ~100KB for
v3). We have zodToConvex() calls from convex-helpers/server/zod4
that execute at module load time, plus z.object().parse() for env
validation. These pull the full zod v4 runtime into the isolate.
What we tried:
- convex-helpers@0.1.114 with convex-helpers/server/zod4 imports
- convex@1.34.0 (latest)
- Externalizing zod in convex.json (only works for node, not
isolate)
- Clean install with single zod v4 version across monorepo
What worked before: Everything deployed fine on Zod v3 with the
same codebase. Only the zod v3→v4 upgrade triggers the OOM.
Using: convex@1.34.0, convex-helpers@0.1.114, zod@4.2.1
JavaScript execution ran out of memory (maximum memory usage: 64 MB)
Bundle analysis (via --debug-bundle-path):
- Isolate: 399 files, 6.0 MB source code
- Node: 121 files, 19.1 MB source code
- fullConfig.json: 44 MB total
The isolate bundle is well under the 32 MiB code limit. The issue
is runtime memory during module initialization, not bundle size.
Root cause: Zod v4 core is ~700KB in the isolate (vs ~100KB for
v3). We have zodToConvex() calls from convex-helpers/server/zod4
that execute at module load time, plus z.object().parse() for env
validation. These pull the full zod v4 runtime into the isolate.
What we tried:
- convex-helpers@0.1.114 with convex-helpers/server/zod4 imports
- convex@1.34.0 (latest)
- Externalizing zod in convex.json (only works for node, not
isolate)
- Clean install with single zod v4 version across monorepo
What worked before: Everything deployed fine on Zod v3 with the
same codebase. Only the zod v3→v4 upgrade triggers the OOM.
Using: convex@1.34.0, convex-helpers@0.1.114, zod@4.2.1
