wrangler 4.143.0: published cli.d.ts imports modules that are not dependencies, so skipLibCheck: false fails

[MAIAppraiser]

What versions & operating system are you using?

• wrangler@4.143.0 (which depends on miniflare@5.20260926.0-alpha)
• @cloudflare/workers-types@5.20260929.1, installed because it is wrangler's optional peer dependency
• @types/node@26.4.1
• typescript@7.0.2; also reproduced with typescript@5.9.3
• Node 22.23.1, npm 11.12.1, macOS arm64

Minimal reproduction

package.json:

{
  "name": "repro-wrangler-types",
  "private": true,
  "type": "module",
  "devDependencies": {
    "@cloudflare/workers-types": "^5.20260929.1",
    "@types/node": "26.4.1",
    "typescript": "7.0.2",
    "wrangler": "4.143.0"
  }
}

tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["ESNext", "DOM", "DOM.Iterable"],
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "skipLibCheck": false,
    "noEmit": true,
    "types": ["node"]
  },
  "include": ["index.ts"]
}

index.ts:

import type { GetPlatformProxyOptions } from "wrangler";

export const options: GetPlatformProxyOptions = {};

Commands:

npm install
npx tsc -p tsconfig.json

Describe the bug

tsc exits 1 with 20 errors, all in published declaration files: 10 in wrangler/wrangler-dist/cli.d.ts and 10 in miniflare/dist/src/index.d.ts. TypeScript 5.9.3 reports the same 20 errors (exit 2).

wrangler-dist/cli.d.ts, the types entry of the package, imports modules that are neither dependencies nor peer dependencies of wrangler:

wrangler/wrangler-dist/cli.d.ts(1,423): error TS2307: Cannot find module '@cloudflare/workers-utils' or its corresponding type declarations.
wrangler/wrangler-dist/cli.d.ts(10,61): error TS2307: Cannot find module '@cloudflare/containers-shared' or its corresponding type declarations.
wrangler/wrangler-dist/cli.d.ts(13,43): error TS2307: Cannot find module '@cloudflare/workers-shared' or its corresponding type declarations.
wrangler/wrangler-dist/cli.d.ts(14,148): error TS2307: Cannot find module '@cloudflare/remote-bindings' or its corresponding type declarations.
wrangler/wrangler-dist/cli.d.ts(17,111): error TS2307: Cannot find module 'yargs' or its corresponding type declarations.
wrangler/wrangler-dist/cli.d.ts(18,24): error TS2307: Cannot find module 'cloudflare' or its corresponding type declarations.

The same file also imports devtools-protocol and devtools-protocol/types/protocol-mapping, which are not dependencies either.

The miniflare errors are the ones described in #15377 (./shared is missing, and @cloudflare/workers-shared and @cloudflare/config are unresolved). They are still present in miniflare@5.20260926.0-alpha, the version that wrangler@4.143.0 pins, so every consumer of wrangler's types inherits them.

skipLibCheck: true hides all of these errors.

Expected behavior

The types entry of wrangler references only modules that the package ships or declares as dependencies or peer dependencies. Importing a documented type such as GetPlatformProxyOptions then typechecks with skipLibCheck: false.

Why it matters

Libraries that expose wrangler types in their own public declarations pass these errors on to their users. For example, @opennextjs/cloudflare imports GetPlatformProxyOptions in dist/api/cloudflare-context.d.ts.

[workers-devprod]

Automated triage

Issue assessment

• Actionability: ✅ Actionable.
• Type: Bug.
• Reproduction: Automatic attempt requested.
• Labels:
  • package:wrangler (high)
  • package:miniflare (medium)
  • package:workers-utils (low)

Actionability and missing information

Actionable bug: wrangler 4.143.0's published types entry imports modules absent from its dependency metadata, and the pinned miniflare alpha adds ten more declaration errors, so consumers typechecking with skipLibCheck disabled fail; a minimal repro with exact versions is provided.

Reproduction reason: The report gives exact dependency versions, a minimal project, and tsc commands showing wrangler's published cli.d.ts fails typecheck with skipLibCheck disabled, so the current defect can be verified.

Reproduction

• Result: ✅ Reproduced.
• Summary: Reproduced: with skipLibCheck:false, importing GetPlatformProxyOptions from wrangler 4.143.0 makes tsc exit 1 with 20 errors in published .d.ts files (10 in wrangler-dist/cli.d.ts, 10 in miniflare index.d.ts); skipLibCheck:true baseline exits 0.

Evidence and attempted steps

Steps attempted:

1. Created a package-only fixture (package.json, tsconfig.json with skipLibCheck:false, index.ts importing GetPlatformProxyOptions from wrangler) pinning the issue's exact dependency versions, and installed with npm 10.9.8 on Node v22.23.2 (Linux x86_64).
   • Command: npm install --no-audit --no-fund
2. Primary reproduction with skipLibCheck: false.
   • Command: npx tsc -p tsconfig.json
3. Single baseline run with skipLibCheck: true to distinguish the report from a broken setup.
   • Command: npx tsc -p tsconfig.skipLibCheck-true.json
4. Corroborated the published artifact: wrangler's types entry is wrangler-dist/cli.d.ts, its declared deps exclude all failing modules, and cli.d.ts literally imports them.
   • Command: node -e "const p=require('wrangler/package.json'); console.log(p.types, Object.keys(p.dependencies), Object.keys(p.peerDependencies||{}))"

Expected behavior: With skipLibCheck: false, importing a documented type (GetPlatformProxyOptions) from wrangler 4.143.0 should typecheck cleanly (exit 0), because the package's "types" entry (wrangler-dist/cli.d.ts) should only reference modules wrangler ships or declares as dependencies/peer dependencies.

Observed behavior: tsc (typescript 7.0.2) exited 1 with exactly 20 errors, all in published declaration files: 10 in wrangler/wrangler-dist/cli.d.ts (TS2307 for cloudflare/workers-utils, devtools-protocol, devtools-protocol/types/protocol-mapping, cloudflare/containers-shared, cloudflare/workers-shared, cloudflare/remote-bindings, yargs, cloudflare — matching the issue's quoted line:col positions such as (1,423), (10,61), (13,43), (14,148), (17,111), (18,24)) and 10 in miniflare/dist/src/index.d.ts (TS2307 for ./shared, cloudflare/workers-shared, cloudflare/config, puppeteer/browsers, zod, plus TS2305/TS7016). Single baseline run with skipLibCheck: true exited 0 with no output. Corroborated: none of the failing modules is declared in wrangler's dependencies (blake3-wasm, esbuild, path-to-regexp, unenv, workerd, cloudflare/kv-asset-handler, miniflare, cloudflare/unenv-preset) or peerDependencies (cloudflare/workers-types), and the published cli.d.ts literally imports them.

Artifact: Download reproduction archive (Cloudflare Access required).

Treat archive contents as untrusted. Inspect them before running anything.

---

This summary was generated by an LLM and may contain errors. Please verify its findings.

Triage bot commands and options

Repository collaborators with write or admin access can trigger actions by commenting on this issue:

• @workers-devprod reproduce: Attempt to reproduce the issue using its description and recent comments.