Zod error

[BorisKamp]

Describe the Bug

Hi!

THis is my package.json in my extension:

...
"dependencies": {
    "@directus/errors": "^2.0.3",
    "axios": "^1.11.0",
    "dayjs": "^1.11.14",
    "express": "5.1.0",
    "raw-body": "^3.0.0",
    "slugify": "^1.6.6",
    "stripe": "^18.5.0",
    "uuid": "^11.1.0",
    "zod": "^4.1.3"
  },
...

Now I just bumped from 11.10.0 to 10.11.0 with D itself and I get this error when running:

directus-1   | file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/schemas.js:865
directus-1   |     const first = def.options[0]._zod.run;
directus-1   |                                       ^
directus-1   | 
directus-1   | TypeError: Cannot read properties of undefined (reading 'run')
directus-1   |     at file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/schemas.js:865:39
directus-1   |     at Function.init (file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/core.js:14:9)
directus-1   |     at file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/classic/schemas.js:544:20
directus-1   |     at Function.init (file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/core.js:14:9)
directus-1   |     at file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/classic/schemas.js:556:14
directus-1   |     at init (file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/core.js:14:9)
directus-1   |     at new ZodDiscriminatedUnion (file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/core/core.js:31:9)
directus-1   |     at Module.discriminatedUnion (file:///directus/node_modules/.pnpm/zod@4.0.14/node_modules/zod/v4/classic/schemas.js:561:12)
directus-1   |     at file:///directus/node_modules/.pnpm/@directus+api@file+api_@types+node@24.2.0_jiti@1.21.7_typescript@5.8.3/node_modules/@directus/api/dist/websocket/messages.js:4:36
directus-1   |     at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
directus-1   | 
directus-1   | Node.js v22.18.0
directus-1 exited with code 1

I have broken my head around it, updated my own deps, restarted, removed node modules, dist folder, lockfile reran npm i etc etc, nothing works.

When I revert back to 11.10.0 and zod 3.24.2 it works again...

Any clue?

To Reproduce

See above

Directus Version

v11.11.0

Hosting Strategy

Self-Hosted (Docker Image)

Database

postgres 17

[linear]

CMS-1287 Zod error

[br41nslug]

Can you share some extra debug information:

• When is this error happening?
• What does the extension do? (from the error it looks like something with websockets perhaps)
• Can the error be reproduced without the extension installed?

[BorisKamp]

@br41nslug sure, here you go:

1. It happens when I run docker compose up to start the project (So I cannot run the project)
2. The extension has custom rest endpoints and hooks, the extension has nothing to do with websockets, although it might look like this as it is mentioned in the error. The extension uses Zod for data validation for the custom endpoints, so the package.json of the extension has zod as a dependencies item.
3. I have to check. I feel like the error is because the zod version of my extension and the one used by Directus internally are colliding, can the be the reason?

[br41nslug]

I feel like the error is because the zod version of my extension and the one used by Directus internally are colliding, can the be the reason?

That could very well be possible. In this PR released 11.10.1 we bumped the Zod version used in the API from 3.24.2 to 4.0.14

[BorisKamp]

I feel like the error is because the zod version of my extension and the one used by Directus internally are colliding, can the be the reason?

That could very well be possible. In this PR released 11.10.1 we bumped the Zod version used in the API from 3.24.2 to 4.0.14

Yeah exactly, and exactly from version 11.10.1 I started getting this issue, so Im still on 11.10.0.

So how do we fix this? Seems anyone using Zod themselves in extensions can get this issue?

[br41nslug]

So how do we fix this?

First we'll have to be able to reproduce this issue.

I've created the following basic hook extension using zod (tried both 3.24 and 4.1) but I cannot reproduce the error so far. Tested the extension both running locally and with a docker container of 11.11.0.

import { defineHook } from '@directus/extensions-sdk';
import { z } from 'zod';

export default defineHook(() => {

	const Player = z.object({ 
		username: z.string(),
		xp: z.number()
	});

	Player.parse({ username: "billie", xp: 100 });
});

How are you installing this extension? This issue seems to be related to pnpm installing extensions in custom docker images 🤔

Related issue directus-labs/extensions#232

The current workaround seems to be to move zod to a devDependency in the extension.

[BorisKamp]

Hi @br41nslug thanks for the info!

I can confirm that setting zod as devDependency in my extension does not solve the issue when on 11.11.0

Here is my Dockerfile:

FROM directus/directus:11.11.0

USER root

RUN corepack enable

USER node

RUN pnpm install @directus/extensions-sdk directus-sync directus-extension-sync directus-extension-flow-manager

COPY --chown=node:node ./snapshots /directus/snapshots
COPY --chown=node:node ./extensions /directus/extensions
COPY --chown=node:node ./templates /directus/templates
COPY --chown=node:node ./directus-config /directus/directus-config
COPY --chown=node:node ./build_extensions.sh /directus/build_extensions.sh

RUN sh /directus/build_extensions.sh

And here is my full extension's package.json:

{
  "name": "directus-bundle-group",
  "type": "module",
  "version": "1.0.0",
  "description": "Please enter a description for your extension",
  "keywords": [
    "directus",
    "directus-extension",
    "directus-extension-bundle"
  ],
  "icon": "extension",
  "files": [
    "dist"
  ],
  "directus:extension": {
    "type": "bundle",
    "path": {
      "app": "dist/app.js",
      "api": "dist/api.js"
    },
    "entries": [
      {
        "type": "endpoint",
        "name": "endpoint-users",
        "source": "src/endpoint-users/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-users",
        "source": "src/hook-users/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-businesses",
        "source": "src/endpoint-businesses/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-businesses",
        "source": "src/hook-businesses/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-groups",
        "source": "src/endpoint-groups/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-dotoos",
        "source": "src/endpoint-dotoos/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-tickets",
        "source": "src/hook-tickets/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-memberships",
        "source": "src/endpoint-memberships/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-groups-businesses-directus-users",
        "source": "src/hook-groups-businesses-directus-users/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-cronjobs",
        "source": "src/hook-cronjobs/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-tokens",
        "source": "src/endpoint-tokens/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-notes",
        "source": "src/endpoint-notes/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-checkbook",
        "source": "src/endpoint-checkbook/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-messages",
        "source": "src/endpoint-messages/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-dotoos",
        "source": "src/hook-dotoos/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-orders",
        "source": "src/endpoint-orders/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-dotoo-waitinglist-users",
        "source": "src/hook-dotoo-waitinglist-users/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-groups",
        "source": "src/hook-groups/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-group-waitinglist-users",
        "source": "src/hook-group-waitinglist-users/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-dotoo-templates",
        "source": "src/hook-dotoo-templates/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-stripe",
        "source": "src/endpoint-stripe/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-businesses-directus-users",
        "source": "src/hook-businesses-directus-users/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-business-settings-vat-rates",
        "source": "src/hook-business-settings-vat-rates/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-raw-body",
        "source": "src/hook-raw-body/index.ts"
      },
      {
        "type": "endpoint",
        "name": "endpoint-members",
        "source": "src/endpoint-members/index.ts"
      },
      {
        "type": "hook",
        "name": "hook-orders",
        "source": "src/hook-orders/index.ts"
      }
    ],
    "host": "^10.10.0"
  },
  "scripts": {
    "build": "directus-extension build",
    "dev": "directus-extension build -w --no-minify",
    "link": "directus-extension link",
    "validate": "directus-extension validate",
    "add": "directus-extension add",
    "generate-gql-types": "npm run introspect & npm run codegen",
    "introspect": "tsx scripts/introspect-graphql.ts",
    "codegen": "graphql-codegen --config scripts/codegen.ts"
  },
  "dependencies": {
    "@directus/errors": "^2.0.3",
    "axios": "^1.11.0",
    "dayjs": "^1.11.15",
    "express": "5.1.0",
    "raw-body": "^3.0.0",
    "slugify": "^1.6.6",
    "stripe": "^18.5.0",
    "uuid": "^11.1.0"
  },
  "devDependencies": {
    "@directus/extensions-sdk": "16.0.1",
    "@graphql-codegen/cli": "^5.0.7",
    "@graphql-codegen/typescript": "^4.1.6",
    "@graphql-codegen/typescript-operations": "^4.6.1",
    "@types/node": "^24.3.0",
    "@types/node-fetch": "^2.6.13",
    "joi": "^18.0.1",
    "tsx": "^4.20.5",
    "typescript": "^5.9.2",
    "zod": "^4.1.5"
  }
}

[BorisKamp]

@br41nslug any further info needed?

[br41nslug]

any further info needed?

Nope 😄 with that related issue I was able to reproduce it