`tanstack-start-trigger-wrapper.ts` static import of `dev-triggers.ts` crashes entire app when queue/cron handlers have `createRequire` dependencies
@TheAlexLichter is already working on this.
Since Jun 9, 2026.
Assessment
This issue has not been assessed yet.
Description
Encountered a weird interaction when using Mastra with crons and queues. Once again, I've asked Claude to help dig into this in hopes that it'll help.
Appreciate it!
Environment
void: 0.9.2vite-plus: 0.1.24@cloudflare/vite-plugin: 1.39.2- Framework: TanStack Start (Class A)
- Compatibility date:
2026-02-24
What happens
Void generates .void/tanstack-start-trigger-wrapper.ts for Class A frameworks. In dev mode this wrapper contains a static top-level import:
import { handleDevTrigger } from './dev-triggers.ts';
.void/dev-triggers.ts (also auto-generated) statically imports every queue and cron handler:
import __job0 from "/path/to/crons/briefing-tick.ts";
import __queue0 from "/path/to/queues/briefing-generation.ts";
If any queue or cron handler transitively imports a package that uses createRequire from Node's module API — in this case @mastra/core, which does so in its gateway/LSP chunks — the TanStack Start worker runner throws on every single request:
require is not defined
at runInRunnerObject (workers/runner-worker/index.js:107:3)
at Object.fetch (.void/tanstack-start-trigger-wrapper.ts:7:34)
at maybeCaptureError (workers/runner-worker/index.js:51:10)
The app is completely broken — not just the dev trigger curls, every page load returns 500.
Why
The static import forces dev-triggers.ts (and therefore all queue/cron handlers and their full dependency trees) to be evaluated at worker module initialization time, before any request is handled. In TanStack Start's workerd-based runner, createRequire from node:module exists but the function it returns throws require is not defined when invoked against CJS modules. Try-catch blocks inside @mastra/core don't help because the import itself (module evaluation) is what fails.
Expected behavior
handleDevTrigger is only needed for POST /__void/scheduled and POST /__void/queue — requests that are only issued during local dev testing. The import should not cause every other request to break.
Minimal repro
- TanStack Start project with
void≥ 0.9.x - A queue handler in
queues/that imports@mastra/core(or any package usingcreateRequirefromnode:module) - Run
pnpm devand load any page — 500 on every request
Suggested fix
Convert the static import to a lazy dynamic import, only evaluated when a dev trigger path is detected:
// In the generated tanstack-start-trigger-wrapper.ts fetch handler:
async fetch(request, env, ctx) {
const url = new URL(request.url);
if (request.method === "POST" &&
(url.pathname === "/__void/scheduled" || url.pathname === "/__void/queue")) {
const { handleDevTrigger } = await import('./dev-triggers.ts');
const res = await handleDevTrigger(request, env, ctx);
if (res) return res;
}
return serveWithAssets(request, env, await original.fetch(request, env, ctx));
},
This ensures queue/cron handlers are only loaded when actually needed, isolating their dependency trees from the critical request path.
Workaround (in use)
Created a Vite plugin to patch the generated wrapper at dev-server startup to omit the dev-triggers.ts import entirely. Dev triggers are handled via TanStack routes instead.
- Dominant language
- TypeScript
- Stars
- 149
- Forks
- 2
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from void-sdk/void
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Incorrect bindings Open
Difficulty 4/5 3-5 days Newbie friendliness 48/100
-
Difficulty 4/5 3-5 days Newbie friendliness 42/100
-
Difficulty 3/5 1-2 days Newbie friendliness 57/100
Similar issues
-
VerificationGate: ATTRIBUTION quote guard never matches a normal quotation (\b around the quote) Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
danielmiessler/LifeOS#2234 ·
-
T: Bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
-
Mend: dependency security vulnerability untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 70/100