@bram-dc/fastify-type-provider-zod 5.0.0 → 5.0.3

package/dist/esm/zod-to-json.js

@@ -0,0 +1,98 @@
+import { $ZodRegistry, toJSONSchema, $ZodType } from "zod/v4/core";
+const getSchemaId = (id, io) => {
+  return io === "input" ? `${id}Input` : id;
+};
+const getReferenceUri = (id, io) => {
+  return `#/components/schemas/${getSchemaId(id, io)}`;
+};
+function isZodDate(entity) {
+  return entity instanceof $ZodType && entity._zod.def.type === "date";
+}
+function isZodUnion(entity) {
+  return entity instanceof $ZodType && entity._zod.def.type === "union";
+}
+function isZodUndefined(entity) {
+  return entity instanceof $ZodType && entity._zod.def.type === "undefined";
+}
+const getOverride = (ctx, io) => {
+  if (isZodUnion(ctx.zodSchema)) {
+    ctx.jsonSchema.anyOf = ctx.jsonSchema.anyOf?.filter((schema) => Object.keys(schema).length > 0);
+  }
+  if (isZodDate(ctx.zodSchema)) {
+    if (io === "output") {
+      ctx.jsonSchema.type = "string";
+      ctx.jsonSchema.format = "date-time";
+    }
+  }
+  if (isZodUndefined(ctx.zodSchema)) {
+    if (io === "output") {
+      ctx.jsonSchema.type = "null";
+    }
+  }
+};
+const zodSchemaToJson = (zodSchema, registry, io) => {
+  const schemaRegistryEntry = registry.get(zodSchema);
+  if (schemaRegistryEntry?.id) {
+    return {
+      $ref: getReferenceUri(schemaRegistryEntry.id, io)
+    };
+  }
+  const tempID = "GEN";
+  const tempRegistry = new $ZodRegistry();
+  tempRegistry.add(zodSchema, { id: tempID });
+  const {
+    schemas: { [tempID]: result }
+  } = toJSONSchema(tempRegistry, {
+    target: "draft-2020-12",
+    metadata: registry,
+    io,
+    unrepresentable: "any",
+    cycles: "ref",
+    reused: "inline",
+    /**
+     * The uri option only allows customizing the base path of the `$ref`, and it automatically appends a path to it.
+     * As a workaround, we set a placeholder that looks something like this:
+     *
+     * |       marker          | always added by zod | meta.id |
+     * |__SCHEMA__PLACEHOLDER__|      #/$defs/       | User    |
+     *
+     * @example `__SCHEMA__PLACEHOLDER__#/$defs/User"`
+     * @example `__SCHEMA__PLACEHOLDER__#/$defs/Group"`
+     *
+     * @see jsonSchemaReplaceRef
+     * @see https://github.com/colinhacks/zod/issues/4750
+     */
+    uri: () => `__SCHEMA__PLACEHOLDER__`,
+    override: (ctx) => getOverride(ctx, io)
+  });
+  const jsonSchema = { ...result };
+  delete jsonSchema.id;
+  const jsonSchemaReplaceRef = JSON.stringify(jsonSchema).replaceAll(
+    /"__SCHEMA__PLACEHOLDER__#\/\$defs\/(.+?)"/g,
+    (_, id) => `"${getReferenceUri(id, io)}"`
+  );
+  return JSON.parse(jsonSchemaReplaceRef);
+};
+const zodRegistryToJson = (registry, io) => {
+  const result = toJSONSchema(registry, {
+    target: "draft-2020-12",
+    io,
+    unrepresentable: "any",
+    cycles: "ref",
+    reused: "inline",
+    uri: (id) => getReferenceUri(id, io),
+    override: (ctx) => getOverride(ctx, io)
+  }).schemas;
+  const jsonSchemas = {};
+  for (const id in result) {
+    const jsonSchema = { ...result[id] };
+    delete jsonSchema.id;
+    jsonSchemas[getSchemaId(id, io)] = jsonSchema;
+  }
+  return jsonSchemas;
+};
+export {
+  zodRegistryToJson,
+  zodSchemaToJson
+};
+//# sourceMappingURL=zod-to-json.js.map

package/dist/esm/zod-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.js","sources":["../../src/zod-to-json.ts"],"sourcesContent":["import type { $ZodDate, $ZodUndefined, $ZodUnion, JSONSchema } from 'zod/v4/core'\nimport { $ZodRegistry, $ZodType, toJSONSchema } from 'zod/v4/core'\n\nconst getSchemaId = (id: string, io: 'input' | 'output') => {\n  return io === 'input' ? `${id}Input` : id\n}\n\nconst getReferenceUri = (id: string, io: 'input' | 'output') => {\n  return `#/components/schemas/${getSchemaId(id, io)}`\n}\n\nfunction isZodDate(entity: unknown): entity is $ZodDate {\n  return entity instanceof $ZodType && entity._zod.def.type === 'date'\n}\n\nfunction isZodUnion(entity: unknown): entity is $ZodUnion {\n  return entity instanceof $ZodType && entity._zod.def.type === 'union'\n}\n\nfunction isZodUndefined(entity: unknown): entity is $ZodUndefined {\n  return entity instanceof $ZodType && entity._zod.def.type === 'undefined'\n}\n\nconst getOverride = (\n  ctx: {\n    zodSchema: $ZodType\n    jsonSchema: JSONSchema.BaseSchema\n  },\n  io: 'input' | 'output',\n) => {\n  if (isZodUnion(ctx.zodSchema)) {\n    // Filter unrepresentable types in unions\n    // TODO: Should be fixed upstream and not merged in this plugin.\n    // Remove when passed: https://github.com/colinhacks/zod/pull/5013\n    ctx.jsonSchema.anyOf = ctx.jsonSchema.anyOf?.filter((schema) => Object.keys(schema).length > 0)\n  }\n\n  if (isZodDate(ctx.zodSchema)) {\n    // Allow dates to be represented as strings in output schemas\n    if (io === 'output') {\n      ctx.jsonSchema.type = 'string'\n      ctx.jsonSchema.format = 'date-time'\n    }\n  }\n\n  if (isZodUndefined(ctx.zodSchema)) {\n    // Allow undefined to be represented as null in output schemas\n    if (io === 'output') {\n      ctx.jsonSchema.type = 'null'\n    }\n  }\n}\n\nexport const zodSchemaToJson: (\n  zodSchema: $ZodType,\n  registry: $ZodRegistry<{ id?: string }>,\n  io: 'input' | 'output',\n) => JSONSchema.BaseSchema = (zodSchema, registry, io) => {\n  const schemaRegistryEntry = registry.get(zodSchema)\n\n  /**\n   * Checks whether the provided schema is registered in the given registry.\n   * If it is present and has an `id`, it can be referenced as component.\n   *\n   * @see https://github.com/turkerdev/fastify-type-provider-zod/issues/173\n   */\n  if (schemaRegistryEntry?.id) {\n    return {\n      $ref: getReferenceUri(schemaRegistryEntry.id, io),\n    }\n  }\n\n  /**\n   * Unfortunately, at the time of writing, there is no way to generate a schema with `$ref`\n   * using `toJSONSchema` and a zod schema.\n   *\n   * As a workaround, we create a zod registry containing only the specific schema we want to convert.\n   *\n   * @see https://github.com/colinhacks/zod/issues/4281\n   */\n  const tempID = 'GEN'\n  const tempRegistry = new $ZodRegistry<{ id?: string }>()\n  tempRegistry.add(zodSchema, { id: tempID })\n\n  const {\n    schemas: { [tempID]: result },\n  } = toJSONSchema(tempRegistry, {\n    target: 'draft-2020-12',\n    metadata: registry,\n    io,\n    unrepresentable: 'any',\n    cycles: 'ref',\n    reused: 'inline',\n\n    /**\n     * The uri option only allows customizing the base path of the `$ref`, and it automatically appends a path to it.\n     * As a workaround, we set a placeholder that looks something like this:\n     *\n     * |       marker          | always added by zod | meta.id |\n     * |__SCHEMA__PLACEHOLDER__|      #/$defs/       | User    |\n     *\n     * @example `__SCHEMA__PLACEHOLDER__#/$defs/User\"`\n     * @example `__SCHEMA__PLACEHOLDER__#/$defs/Group\"`\n     *\n     * @see jsonSchemaReplaceRef\n     * @see https://github.com/colinhacks/zod/issues/4750\n     */\n    uri: () => `__SCHEMA__PLACEHOLDER__`,\n    override: (ctx) => getOverride(ctx, io),\n  })\n\n  const jsonSchema = { ...result }\n  delete jsonSchema.id\n\n  /**\n   * Replace the previous generated placeholders with the final `$ref` value\n   */\n  const jsonSchemaReplaceRef = JSON.stringify(jsonSchema).replaceAll(\n    /\"__SCHEMA__PLACEHOLDER__#\\/\\$defs\\/(.+?)\"/g,\n    (_, id) => `\"${getReferenceUri(id, io)}\"`,\n  )\n\n  return JSON.parse(jsonSchemaReplaceRef) as typeof result\n}\n\nexport const zodRegistryToJson: (\n  registry: $ZodRegistry<{ id?: string }>,\n  io: 'input' | 'output',\n) => Record<string, JSONSchema.BaseSchema> = (registry, io) => {\n  const result = toJSONSchema(registry, {\n    target: 'draft-2020-12',\n    io,\n    unrepresentable: 'any',\n    cycles: 'ref',\n    reused: 'inline',\n    uri: (id) => getReferenceUri(id, io),\n    override: (ctx) => getOverride(ctx, io),\n  }).schemas\n\n  const jsonSchemas: Record<string, JSONSchema.BaseSchema> = {}\n  for (const id in result) {\n    const jsonSchema = { ...result[id] }\n\n    delete jsonSchema.id\n\n    jsonSchemas[getSchemaId(id, io)] = jsonSchema\n  }\n\n  return jsonSchemas\n}\n"],"names":[],"mappings":";AAGA,MAAM,cAAc,CAAC,IAAY,OAA2B;AAC1D,SAAO,OAAO,UAAU,GAAG,EAAE,UAAU;AACzC;AAEA,MAAM,kBAAkB,CAAC,IAAY,OAA2B;AAC9D,SAAO,wBAAwB,YAAY,IAAI,EAAE,CAAC;AACpD;AAEA,SAAS,UAAU,QAAqC;AACtD,SAAO,kBAAkB,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,SAAS,WAAW,QAAsC;AACxD,SAAO,kBAAkB,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,SAAS,eAAe,QAA0C;AAChE,SAAO,kBAAkB,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,MAAM,cAAc,CAClB,KAIA,OACG;AACH,MAAI,WAAW,IAAI,SAAS,GAAG;AAI7B,QAAI,WAAW,QAAQ,IAAI,WAAW,OAAO,OAAO,CAAC,WAAW,OAAO,KAAK,MAAM,EAAE,SAAS,CAAC;AAAA,EAChG;AAEA,MAAI,UAAU,IAAI,SAAS,GAAG;AAE5B,QAAI,OAAO,UAAU;AACnB,UAAI,WAAW,OAAO;AACtB,UAAI,WAAW,SAAS;AAAA,IAC1B;AAAA,EACF;AAEA,MAAI,eAAe,IAAI,SAAS,GAAG;AAEjC,QAAI,OAAO,UAAU;AACnB,UAAI,WAAW,OAAO;AAAA,IACxB;AAAA,EACF;AACF;AAEO,MAAM,kBAIgB,CAAC,WAAW,UAAU,OAAO;AACxD,QAAM,sBAAsB,SAAS,IAAI,SAAS;AAQlD,MAAI,qBAAqB,IAAI;AAC3B,WAAO;AAAA,MACL,MAAM,gBAAgB,oBAAoB,IAAI,EAAE;AAAA,IAAA;AAAA,EAEpD;AAUA,QAAM,SAAS;AACf,QAAM,eAAe,IAAI,aAAA;AACzB,eAAa,IAAI,WAAW,EAAE,IAAI,QAAQ;AAE1C,QAAM;AAAA,IACJ,SAAS,EAAE,CAAC,MAAM,GAAG,OAAA;AAAA,EAAO,IAC1B,aAAa,cAAc;AAAA,IAC7B,QAAQ;AAAA,IACR,UAAU;AAAA,IACV;AAAA,IACA,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAeR,KAAK,MAAM;AAAA,IACX,UAAU,CAAC,QAAQ,YAAY,KAAK,EAAE;AAAA,EAAA,CACvC;AAED,QAAM,aAAa,EAAE,GAAG,OAAA;AACxB,SAAO,WAAW;AAKlB,QAAM,uBAAuB,KAAK,UAAU,UAAU,EAAE;AAAA,IACtD;AAAA,IACA,CAAC,GAAG,OAAO,IAAI,gBAAgB,IAAI,EAAE,CAAC;AAAA,EAAA;AAGxC,SAAO,KAAK,MAAM,oBAAoB;AACxC;AAEO,MAAM,oBAGgC,CAAC,UAAU,OAAO;AAC7D,QAAM,SAAS,aAAa,UAAU;AAAA,IACpC,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,KAAK,CAAC,OAAO,gBAAgB,IAAI,EAAE;AAAA,IACnC,UAAU,CAAC,QAAQ,YAAY,KAAK,EAAE;AAAA,EAAA,CACvC,EAAE;AAEH,QAAM,cAAqD,CAAA;AAC3D,aAAW,MAAM,QAAQ;AACvB,UAAM,aAAa,EAAE,GAAG,OAAO,EAAE,EAAA;AAEjC,WAAO,WAAW;AAElB,gBAAY,YAAY,IAAI,EAAE,CAAC,IAAI;AAAA,EACrC;AAEA,SAAO;AACT;"}

package/package.json

@@ -1,61 +1,76 @@
 {
-    "name": "@bram-dc/fastify-type-provider-zod",
-    "version": "5.0.0",
-    "description": "Zod Type Provider for Fastify@5",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "README.md",
-        "LICENSE",
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "test": "npm run build && npm run typescript && vitest",
-        "test:coverage": "vitest --coverage",
-        "lint": "biome check . && tsc --project tsconfig.lint.json --noEmit",
-        "lint:fix": "biome check --write .",
-        "typescript": "tsd",
-        "prepublishOnly": "npm run build"
+  "name": "@bram-dc/fastify-type-provider-zod",
+  "version": "5.0.3",
+  "description": "Zod Type Provider for Fastify@5",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.cts",
+  "exports": {
+    "require": {
+      "types": "./dist/cjs/index.d.cts",
+      "default": "./dist/cjs/index.cjs"
     },
-    "peerDependencies": {
-        "fastify": "^5.0.0",
-        "zod": "^4.0.0-beta.20250412T085909"
-    },
-    "repository": {
-        "url": "https://github.com/turkerdev/fastify-type-provider-zod"
-    },
-    "keywords": [
-        "fastify",
-        "zod",
-        "type",
-        "provider"
-    ],
-    "author": "turkerd",
-    "license": "MIT",
-    "bugs": {
-        "url": "https://github.com/turkerdev/fastify-type-provider-zod/issues"
-    },
-    "homepage": "https://github.com/turkerdev/fastify-type-provider-zod",
-    "dependencies": {
-        "@fastify/error": "^4.0.0"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "^1.9.3",
-        "@fastify/swagger": "^9.1.0",
-        "@fastify/swagger-ui": "^5.0.1",
-        "@kibertoad/biome-config": "^1.2.1",
-        "@types/node": "^20.16.10",
-        "@vitest/coverage-v8": "^2.1.2",
-        "fastify": "^5.0.0",
-        "fastify-plugin": "^5.0.1",
-        "oas-validator": "^5.0.8",
-        "tsd": "^0.31.2",
-        "typescript": "^5.6.2",
-        "vitest": "^2.1.2",
-        "zod": "^4.0.0-beta.20250412T085909"
-    },
-    "tsd": {
-        "directory": "types"
+    "default": {
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
     }
-}
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "prepare": "npm run build",
+    "test:coverage": "vitest --coverage",
+    "test:ci": "npm run build && npm run typescript && npm run test:coverage",
+    "lint": "biome check . && tsc --noEmit",
+    "lint:fix": "biome check --write .",
+    "typescript": "tsd",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "url": "https://github.com/turkerdev/fastify-type-provider-zod"
+  },
+  "keywords": [
+    "fastify",
+    "zod",
+    "type",
+    "provider"
+  ],
+  "author": "turkerd",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/turkerdev/fastify-type-provider-zod/issues"
+  },
+  "homepage": "https://github.com/turkerdev/fastify-type-provider-zod",
+  "dependencies": {
+    "@fastify/error": "^4.2.0"
+  },
+  "peerDependencies": {
+    "@fastify/swagger": ">=9.5.1",
+    "fastify": "^5.0.0",
+    "openapi-types": "^12.1.3",
+    "zod": ">=3.25.67"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.6",
+    "@fastify/swagger": "^9.5.1",
+    "@fastify/swagger-ui": "^5.2.3",
+    "@kibertoad/biome-config": "^2.0.0",
+    "@types/node": "^22.16.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "fastify": "^5.4.0",
+    "fastify-plugin": "^5.0.1",
+    "oas-validator": "^5.0.8",
+    "tsd": "^0.32.0",
+    "typescript": "^5.8.3",
+    "unplugin-isolated-decl": "^0.14.5",
+    "vitest": "^3.2.4",
+    "zod": "^4.0.5"
+  },
+  "tsd": {
+    "directory": "types"
+  }
+}

package/src/core.ts

@@ -0,0 +1,244 @@
+import type { SwaggerTransform, SwaggerTransformObject } from '@fastify/swagger'
+import type {
+  FastifyPluginAsync,
+  FastifyPluginCallback,
+  FastifyPluginOptions,
+  FastifySchema,
+  FastifySchemaCompiler,
+  FastifyTypeProvider,
+  RawServerBase,
+  RawServerDefault,
+} from 'fastify'
+import type { FastifySerializerCompiler } from 'fastify/types/schema'
+import type { $ZodRegistry, input, output } from 'zod/v4/core'
+import { $ZodType, globalRegistry, safeParse } from 'zod/v4/core'
+import { createValidationError, InvalidSchemaError, ResponseSerializationError } from './errors'
+import { getOASVersion, jsonSchemaToOAS } from './json-to-oas'
+import { zodRegistryToJson, zodSchemaToJson } from './zod-to-json'
+
+type FreeformRecord = Record<string, any>
+
+const defaultSkipList = [
+  '/documentation/',
+  '/documentation/initOAuth',
+  '/documentation/json',
+  '/documentation/uiConfig',
+  '/documentation/yaml',
+  '/documentation/*',
+  '/documentation/static/*',
+]
+
+export interface ZodTypeProvider extends FastifyTypeProvider {
+  validator: this['schema'] extends $ZodType ? output<this['schema']> : unknown
+  serializer: this['schema'] extends $ZodType ? input<this['schema']> : unknown
+}
+
+interface Schema extends FastifySchema {
+  hide?: boolean
+}
+
+type CreateJsonSchemaTransformOptions = {
+  skipList?: readonly string[]
+  schemaRegistry?: $ZodRegistry<{ id?: string | undefined }>
+}
+
+export const createJsonSchemaTransform = ({
+  skipList = defaultSkipList,
+  schemaRegistry = globalRegistry,
+}: CreateJsonSchemaTransformOptions): SwaggerTransform<Schema> => {
+  return (input) => {
+    if ('swaggerObject' in input) {
+      throw new Error('OpenAPI 2.0 is not supported')
+    }
+
+    const { schema, url } = input
+
+    if (!schema) {
+      return {
+        schema,
+        url,
+      }
+    }
+
+    const { response, headers, querystring, body, params, hide, ...rest } = schema
+
+    const transformed: FreeformRecord = {}
+
+    if (skipList.includes(url) || hide) {
+      transformed.hide = true
+      return { schema: transformed, url }
+    }
+
+    const zodSchemas: FreeformRecord = { headers, querystring, body, params }
+
+    const oasVersion = getOASVersion(input)
+
+    for (const prop in zodSchemas) {
+      const zodSchema = zodSchemas[prop]
+      if (zodSchema) {
+        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, 'input')
+        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion)
+
+        transformed[prop] = oasSchema
+      }
+    }
+
+    if (response) {
+      transformed.response = {}
+
+      for (const prop in response as any) {
+        const zodSchema = resolveSchema((response as any)[prop])
+        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, 'output')
+
+        // Check is the JSON schema is null then return as it is since fastify-swagger will handle it
+        if (jsonSchema.type === 'null') {
+          transformed.response[prop] = jsonSchema
+          continue
+        }
+
+        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion)
+
+        transformed.response[prop] = oasSchema
+      }
+    }
+
+    for (const prop in rest) {
+      const meta = rest[prop as keyof typeof rest]
+      if (meta) {
+        transformed[prop] = meta
+      }
+    }
+
+    return { schema: transformed, url }
+  }
+}
+
+export const jsonSchemaTransform: SwaggerTransform<Schema> = createJsonSchemaTransform({})
+
+type CreateJsonSchemaTransformObjectOptions = {
+  schemaRegistry?: $ZodRegistry<{ id?: string | undefined }>
+}
+
+export const createJsonSchemaTransformObject =
+  ({
+    schemaRegistry = globalRegistry,
+  }: CreateJsonSchemaTransformObjectOptions): SwaggerTransformObject =>
+  (input) => {
+    if ('swaggerObject' in input) {
+      throw new Error('OpenAPI 2.0 is not supported')
+    }
+
+    const oasVersion = getOASVersion(input)
+
+    const inputSchemas = zodRegistryToJson(schemaRegistry, 'input')
+    const outputSchemas = zodRegistryToJson(schemaRegistry, 'output')
+
+    for (const key in outputSchemas) {
+      if (inputSchemas[key]) {
+        throw new Error(
+          `Collision detected for schema "${key}". The is already an input schema with the same name.`,
+        )
+      }
+    }
+
+    const jsonSchemas = {
+      ...inputSchemas,
+      ...outputSchemas,
+    }
+
+    const oasSchemas = Object.fromEntries(
+      Object.entries(jsonSchemas).map(([key, value]) => [key, jsonSchemaToOAS(value, oasVersion)]),
+    )
+
+    return {
+      ...input.openapiObject,
+      components: {
+        ...input.openapiObject.components,
+        schemas: {
+          ...input.openapiObject.components?.schemas,
+          ...oasSchemas,
+        },
+      },
+    } as ReturnType<SwaggerTransformObject>
+  }
+
+export const jsonSchemaTransformObject: SwaggerTransformObject = createJsonSchemaTransformObject({})
+
+export const validatorCompiler: FastifySchemaCompiler<$ZodType> =
+  ({ schema }) =>
+  (data) => {
+    const result = safeParse(schema, data)
+    if (result.error) {
+      return { error: createValidationError(result.error) as unknown as Error }
+    }
+
+    return { value: result.data }
+  }
+
+function resolveSchema(maybeSchema: $ZodType | { properties: $ZodType }): $ZodType {
+  if (maybeSchema instanceof $ZodType) {
+    return maybeSchema
+  }
+  if ('properties' in maybeSchema && maybeSchema.properties instanceof $ZodType) {
+    return maybeSchema.properties
+  }
+  throw new InvalidSchemaError(JSON.stringify(maybeSchema))
+}
+
+type ReplacerFunction = (this: any, key: string, value: any) => any
+
+export type ZodSerializerCompilerOptions = {
+  replacer?: ReplacerFunction
+}
+
+export const createSerializerCompiler =
+  (
+    options?: ZodSerializerCompilerOptions,
+  ): FastifySerializerCompiler<$ZodType | { properties: $ZodType }> =>
+  ({ schema: maybeSchema, method, url }) =>
+  (data) => {
+    const schema = resolveSchema(maybeSchema)
+
+    const result = safeParse(schema, data)
+    if (result.error) {
+      throw new ResponseSerializationError(method, url, { cause: result.error })
+    }
+
+    return JSON.stringify(result.data, options?.replacer)
+  }
+
+export const serializerCompiler: ReturnType<typeof createSerializerCompiler> =
+  createSerializerCompiler({})
+
+/**
+ * FastifyPluginCallbackZod with Zod automatic type inference
+ *
+ * @example
+ * ```typescript
+ * import { FastifyPluginCallbackZod } from "fastify-type-provider-zod"
+ *
+ * const plugin: FastifyPluginCallbackZod = (fastify, options, done) => {
+ *   done()
+ * }
+ * ```
+ */
+export type FastifyPluginCallbackZod<
+  Options extends FastifyPluginOptions = Record<never, never>,
+  Server extends RawServerBase = RawServerDefault,
+> = FastifyPluginCallback<Options, Server, ZodTypeProvider>
+
+/**
+ * FastifyPluginAsyncZod with Zod automatic type inference
+ *
+ * @example
+ * ```typescript
+ * import { FastifyPluginAsyncZod } from "fastify-type-provider-zod"
+ *
+ * const plugin: FastifyPluginAsyncZod = async (fastify, options) => {
+ * }
+ * ```
+ */
+export type FastifyPluginAsyncZod<
+  Options extends FastifyPluginOptions = Record<never, never>,
+  Server extends RawServerBase = RawServerDefault,
+> = FastifyPluginAsync<Options, Server, ZodTypeProvider>

package/src/errors.ts

@@ -0,0 +1,99 @@
+import createError, { type FastifyErrorConstructor } from '@fastify/error'
+import type { FastifyError } from 'fastify'
+import type { FastifySchemaValidationError } from 'fastify/types/schema'
+import type { $ZodError } from 'zod/v4/core'
+
+export const InvalidSchemaError: FastifyErrorConstructor<
+  {
+    code: string
+  },
+  [string]
+> = createError<[string]>('FST_ERR_INVALID_SCHEMA', 'Invalid schema passed: %s', 500)
+
+const ZodFastifySchemaValidationErrorSymbol: symbol = Symbol.for('ZodFastifySchemaValidationError')
+
+export type ZodFastifySchemaValidationError = FastifySchemaValidationError & {
+  [ZodFastifySchemaValidationErrorSymbol]: true
+}
+
+const ResponseSerializationBase: FastifyErrorConstructor<
+  {
+    code: string
+  },
+  [
+    {
+      cause: $ZodError
+    },
+  ]
+> = createError<[{ cause: $ZodError }]>(
+  'FST_ERR_RESPONSE_SERIALIZATION',
+  "Response doesn't match the schema",
+  500,
+)
+
+export class ResponseSerializationError extends ResponseSerializationBase {
+  cause!: $ZodError
+
+  constructor(
+    public method: string,
+    public url: string,
+    options: { cause: $ZodError },
+  ) {
+    super({ cause: options.cause })
+
+    this.cause = options.cause
+  }
+}
+
+export function isResponseSerializationError(value: unknown): value is ResponseSerializationError {
+  return 'method' in (value as ResponseSerializationError)
+}
+
+function isZodFastifySchemaValidationError(
+  error: unknown,
+): error is ZodFastifySchemaValidationError {
+  return (
+    typeof error === 'object' &&
+    error !== null &&
+    (error as ZodFastifySchemaValidationError)[ZodFastifySchemaValidationErrorSymbol] === true
+  )
+}
+
+export function hasZodFastifySchemaValidationErrors(
+  error: unknown,
+): error is Omit<FastifyError, 'validation'> & { validation: ZodFastifySchemaValidationError[] } {
+  return (
+    typeof error === 'object' &&
+    error !== null &&
+    'validation' in error &&
+    Array.isArray(error.validation) &&
+    error.validation.length > 0 &&
+    isZodFastifySchemaValidationError(error.validation[0])
+  )
+}
+
+function omit<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {
+  const result = {} as Omit<T, K>
+  for (const key of Object.keys(obj) as Array<keyof T>) {
+    if (!keys.includes(key as K)) {
+      // @ts-expect-error
+      result[key] = obj[key]
+    }
+  }
+  return result
+}
+
+export function createValidationError(error: $ZodError): ZodFastifySchemaValidationError[] {
+  return error.issues.map((issue) => {
+    return {
+      [ZodFastifySchemaValidationErrorSymbol]: true,
+      keyword: issue.code,
+      instancePath: `/${issue.path.join('/')}`,
+      schemaPath: `#/${issue.path.join('/')}/${issue.code}`,
+      message: issue.message,
+      params: {
+        ...omit(issue, ['path', 'code', 'message']),
+      },
+    }
+  })
+}

package/src/index.ts

@@ -0,0 +1,21 @@
+export {
+  createJsonSchemaTransform,
+  createJsonSchemaTransformObject,
+  createSerializerCompiler,
+  type FastifyPluginAsyncZod,
+  type FastifyPluginCallbackZod,
+  jsonSchemaTransform,
+  jsonSchemaTransformObject,
+  serializerCompiler,
+  validatorCompiler,
+  type ZodSerializerCompilerOptions,
+  type ZodTypeProvider,
+} from './core'
+
+export {
+  hasZodFastifySchemaValidationErrors,
+  InvalidSchemaError,
+  isResponseSerializationError,
+  ResponseSerializationError,
+  type ZodFastifySchemaValidationError,
+} from './errors'