@a_jackie_z/fastify 1.0.1 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @a_jackie_z/fastify
 
-A collection of Fastify plugins and utilities for building robust web applications with built-in support for JWT authentication, rate limiting, Swagger documentation, and TypeBox validation.
+A collection of Fastify plugins and utilities for building robust web applications with built-in support for JWT authentication, rate limiting, Swagger documentation, and Zod validation.
 
 ## Installation
 
@@ -14,7 +14,7 @@ npm install @a_jackie_z/fastify
 
 ```typescript
 import { createFastify, runFastify } from '@a_jackie_z/fastify'
-import { Type } from '@sinclair/typebox'
+import { z } from 'zod'
 
 const app = await createFastify()
 
@@ -23,8 +23,8 @@ app.route({
   url: '/hello',
   schema: {
     response: {
-      200: Type.Object({
-        message: Type.String(),
+      200: z.object({
+        message: z.string(),
       }),
     },
   },
@@ -40,8 +40,8 @@ await runFastify(app, '0.0.0.0', 3000)
 
 - **JWT Authentication** - Built-in JWT support with global and route-level configuration
 - **Rate Limiting** - Global rate limiting for API protection
-- **Swagger Documentation** - Auto-generated API documentation with TypeBox schemas
-- **TypeBox Integration** - Type-safe request/response validation
+- **Swagger Documentation** - Auto-generated API documentation with Zod schemas
+- **Zod Integration** - Type-safe request/response validation
 - **Custom Logger Support** - Integrate any Fastify-compatible logger
 - **Health Check Plugin** - Ready-to-use health check endpoint
 - **Plugin Helper** - Utility for creating reusable Fastify plugins
@@ -52,7 +52,7 @@ await runFastify(app, '0.0.0.0', 3000)
 
 ```typescript
 import { createFastify, runFastify } from '@a_jackie_z/fastify'
-import { Type } from '@sinclair/typebox'
+import { z } from 'zod'
 
 const app = await createFastify({
   // Optional: Integrate your logger
@@ -97,16 +97,16 @@ app.route({
     jwt: false, // Bypass JWT check for login
   },
   schema: {
-    body: Type.Object({
-      username: Type.String(),
-      password: Type.String(),
+    body: z.object({
+      username: z.string(),
+      password: z.string(),
     }),
     response: {
-      200: Type.Object({
-        token: Type.String(),
+      200: z.object({
+        token: z.string(),
       }),
-      401: Type.Object({
-        error: Type.String(),
+      401: z.object({
+        error: z.string(),
       }),
     },
   },
@@ -140,8 +140,8 @@ app.route({
   },
   schema: {
     response: {
-      200: Type.Object({
-        message: Type.String(),
+      200: z.object({
+        message: z.string(),
       }),
     },
   },
@@ -160,9 +160,9 @@ app.route({
   // No config needed - global JWT setting applies
   schema: {
     response: {
-      200: Type.Object({
-        message: Type.String(),
-        user: Type.Unknown(),
+      200: z.object({
+        message: z.string(),
+        user: z.unknown(),
       }),
     },
   },
@@ -191,12 +191,12 @@ app.route({
   },
   schema: {
     response: {
-      200: Type.Object({
-        message: Type.String(),
+      200: z.object({
+        message: z.string(),
       }),
-      403: Type.Object({
-        error: Type.String(),
-        message: Type.String(),
+      403: z.object({
+        error: z.string(),
+        message: z.string(),
       }),
     },
   },
@@ -221,12 +221,12 @@ app.route({
     },
   },
   schema: {
-    params: Type.Object({
-      id: Type.String(),
+    params: z.object({
+      id: z.string(),
     }),
     response: {
-      200: Type.Object({
-        message: Type.String(),
+      200: z.object({
+        message: z.string(),
       }),
     },
   },
@@ -284,15 +284,15 @@ await runFastify(app, '0.0.0.0', 3000)
 
 ```typescript
 import { createFastify, runFastify, createFastifyPlugin } from '@a_jackie_z/fastify'
-import { Type } from '@sinclair/typebox'
+import { z } from 'zod'
 
 // Create a reusable plugin
 const myPlugin = createFastifyPlugin((app) => {
   app.get('/plugin-route', {
     schema: {
       response: {
-        200: Type.Object({
-          message: Type.String(),
+        200: z.object({
+          message: z.string(),
         }),
       },
     },
@@ -309,26 +309,26 @@ await app.register(myPlugin)
 await runFastify(app, '0.0.0.0', 3000)
 ```
 
-### 8. TypeBox Schema Validation
+### 8. Zod Schema Validation
 
 ```typescript
 app.route({
   method: 'POST',
   url: '/users',
   schema: {
-    body: Type.Object({
-      name: Type.String({ minLength: 1, maxLength: 100 }),
-      email: Type.String({ format: 'email' }),
-      age: Type.Optional(Type.Number({ minimum: 0, maximum: 150 })),
+    body: z.object({
+      name: z.string().min(1).max(100),
+      email: z.string().email(),
+      age: z.number().min(0).max(150).optional(),
     }),
     response: {
-      201: Type.Object({
-        id: Type.String(),
-        name: Type.String(),
-        email: Type.String(),
+      201: z.object({
+        id: z.string(),
+        name: z.string(),
+        email: z.string(),
       }),
-      400: Type.Object({
-        error: Type.String(),
+      400: z.object({
+        error: z.string(),
       }),
     },
   },
@@ -391,7 +391,7 @@ type JWTAuthorizationHandler = (
 
 ### `createFastify(options?: CreateFastifyOptions): Promise<FastifyServer>`
 
-Creates and configures a Fastify server instance with TypeBox support and optional plugins.
+Creates and configures a Fastify server instance with Zod support and optional plugins.
 
 ### `runFastify(fastify: FastifyServer, host: string, port: number): Promise<void>`
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as fastify from 'fastify';
 import { FastifyRequest, FastifyReply, FastifyServerOptions, FastifyInstance, RawServerDefault, FastifyBaseLogger, FastifyContextConfig, FastifyPluginCallback } from 'fastify';
-import { TypeBoxTypeProvider } from '@fastify/type-provider-typebox';
+import { ZodTypeProvider } from 'fastify-type-provider-zod';
 import { RateLimitPluginOptions } from '@fastify/rate-limit';
 import { FastifyJWTOptions } from '@fastify/jwt';
 import { IncomingMessage, ServerResponse } from 'node:http';
@@ -38,7 +38,7 @@ interface CreateFastifyOptions {
         routePrefix?: string;
     };
 }
-type FastifyServer = FastifyInstance<RawServerDefault, IncomingMessage, ServerResponse, FastifyBaseLogger, TypeBoxTypeProvider> & FastifyContextConfig;
+type FastifyServer = FastifyInstance<RawServerDefault, IncomingMessage, ServerResponse, FastifyBaseLogger, ZodTypeProvider> & FastifyContextConfig;
 declare function createFastify(options?: CreateFastifyOptions): Promise<FastifyServer>;
 declare function runFastify(fastify: FastifyServer, host: string, port: number): Promise<void>;
 

package/dist/index.js

@@ -1,5 +1,9 @@
 // lib/fastify.ts
 import Fastify from "fastify";
+import {
+  serializerCompiler,
+  validatorCompiler
+} from "fastify-type-provider-zod";
 import fastifyRateLimit from "@fastify/rate-limit";
 import fastifyJwt from "@fastify/jwt";
 import fastifySwagger from "@fastify/swagger";
@@ -10,6 +14,9 @@ async function createFastify(options) {
     fastifyOptions.loggerInstance = options.logger;
   }
   const fastify = Fastify(fastifyOptions).withTypeProvider();
+  fastify.setValidatorCompiler(validatorCompiler);
+  fastify.setSerializerCompiler(serializerCompiler);
+  let swaggerRoutePrefix;
   if (options?.swagger) {
     await fastify.register(fastifySwagger, {
       openapi: {
@@ -27,6 +34,7 @@ async function createFastify(options) {
     if (!routePrefix.endsWith("/")) {
       routePrefix = routePrefix + "/";
     }
+    swaggerRoutePrefix = routePrefix;
     await fastify.register(fastifySwaggerUI, { routePrefix });
   }
   if (options?.jwt) {
@@ -42,6 +50,9 @@ async function createFastify(options) {
     await fastify.register(fastifyJwt, jwtOptions);
     if (options.jwt.global) {
       fastify.addHook("onRequest", async (request, reply) => {
+        if (swaggerRoutePrefix && request.url.startsWith(swaggerRoutePrefix)) {
+          return;
+        }
         const routeConfig = request.routeOptions.config || {};
         const jwtConfig = routeConfig.jwt;
         if (jwtConfig === false) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../lib/fastify.ts","../lib/plugin.ts","../lib/plugins/healthPlugin.ts"],"sourcesContent":["import Fastify, {\n  FastifyBaseLogger,\n  FastifyContextConfig,\n  FastifyInstance,\n  FastifyReply,\n  FastifyServerOptions,\n  RawServerDefault,\n} from 'fastify'\nimport type { FastifyRequest } from 'fastify'\nimport { TypeBoxTypeProvider } from '@fastify/type-provider-typebox'\nimport fastifyRateLimit, { RateLimitPluginOptions } from '@fastify/rate-limit'\nimport fastifyJwt, { FastifyJWTOptions } from '@fastify/jwt'\nimport fastifySwagger, { SwaggerOptions } from '@fastify/swagger'\nimport fastifySwaggerUI, { FastifySwaggerUiOptions } from '@fastify/swagger-ui'\nimport { IncomingMessage, ServerResponse } from 'node:http'\n\nexport type JWTAuthorizationHandler = <TUser = unknown>(\n  request: FastifyRequest,\n  reply: FastifyReply,\n  user: TUser\n) => Promise<boolean> | boolean\n\nexport interface JWTRouteConfig {\n  jwt?:\n    | boolean // true = require JWT, false = bypass JWT\n    | {\n        required?: boolean // Default: true if global enabled\n        authorize?: JWTAuthorizationHandler // Check JWT info before route processing\n      }\n}\n\n// Extend Fastify types to include custom config\ndeclare module 'fastify' {\n  interface FastifyContextConfig {\n    jwt?:\n      | boolean\n      | {\n          required?: boolean\n          authorize?: JWTAuthorizationHandler\n        }\n  }\n}\n\nexport interface CreateFastifyOptions {\n  logger?: FastifyServerOptions['loggerInstance'],\n  rateLimit?: {\n    global?: RateLimitPluginOptions\n  }\n  jwt?: {\n    secret: string\n    sign?: FastifyJWTOptions['sign']\n    verify?: FastifyJWTOptions['verify']\n    global?: boolean // Enable JWT check globally for all routes\n  }\n  swagger?: {\n    title: string\n    version: string\n    description: string\n    routePrefix?: string\n  }\n}\n\nexport type FastifyServer = FastifyInstance<\n  RawServerDefault,\n  IncomingMessage,\n  ServerResponse,\n  FastifyBaseLogger,\n  TypeBoxTypeProvider\n> & FastifyContextConfig\n\nexport async function createFastify(options?: CreateFastifyOptions): Promise<FastifyServer> {\n  const fastifyOptions: FastifyServerOptions = {}\n\n  if (options?.logger) {\n    fastifyOptions.loggerInstance = options.logger\n  }\n\n  const fastify = Fastify(fastifyOptions).withTypeProvider<TypeBoxTypeProvider>()\n\n  // Register Swagger first to capture all routes with TypeBox schemas\n  if (options?.swagger) {\n    await fastify.register(fastifySwagger, {\n      openapi: {\n        info: {\n          title: options.swagger.title,\n          version: options.swagger.version,\n          description: options.swagger.description,\n        },\n      },\n    } as SwaggerOptions)\n\n    let routePrefix = options.swagger.routePrefix || '/docs/'\n\n    if (!routePrefix.startsWith('/')) {\n      routePrefix = '/' + routePrefix\n    }\n\n    if (!routePrefix.endsWith('/')) {\n      routePrefix = routePrefix + '/'\n    }\n\n    await fastify.register(fastifySwaggerUI, { routePrefix } as FastifySwaggerUiOptions)\n  }\n\n  // Register JWT authentication\n  if (options?.jwt) {\n    const jwtOptions: FastifyJWTOptions = {\n      secret: options.jwt.secret,\n    }\n    if (options.jwt.sign !== undefined) {\n      jwtOptions.sign = options.jwt.sign\n    }\n    if (options.jwt.verify !== undefined) {\n      jwtOptions.verify = options.jwt.verify\n    }\n    await fastify.register(fastifyJwt, jwtOptions)\n\n    // Global JWT checking hook\n    if (options.jwt.global) {\n      fastify.addHook('onRequest', async (request, reply) => {\n        const routeConfig = (request.routeOptions.config as JWTRouteConfig) || {}\n        const jwtConfig = routeConfig.jwt\n\n        // Check if route explicitly bypasses JWT\n        if (jwtConfig === false) {\n          return\n        }\n\n        // Check if route explicitly requires JWT or uses global setting\n        const shouldVerify =\n          jwtConfig === true ||\n          (typeof jwtConfig === 'object' && jwtConfig.required !== false) ||\n          (jwtConfig === undefined && options?.jwt?.global === true)\n\n        if (shouldVerify) {\n          try {\n            await request.jwtVerify()\n\n            // Custom authorization - check JWT info before route processing\n            if (typeof jwtConfig === 'object' && jwtConfig.authorize) {\n              const authorized = await jwtConfig.authorize(request, reply, request.user)\n              if (!authorized) {\n                reply.status(403).send({\n                  error: 'Forbidden',\n                  message: 'Authorization failed',\n                })\n                return\n              }\n            }\n          } catch (err) {\n            reply.status(401).send({\n              error: 'Unauthorized',\n              message: 'Invalid or missing JWT token',\n            })\n          }\n        }\n      })\n    }\n  }\n\n  // Register Rate Limiting\n  if (options?.rateLimit?.global) {\n    await fastify.register(fastifyRateLimit, {\n      global: true,\n      ...options.rateLimit.global,\n    })\n  }\n\n  return fastify\n}\n\nexport async function runFastify(fastify: FastifyServer, host: string, port: number) {\n  try {\n    await fastify.listen({ host, port })\n  } catch (err) {\n    fastify.log.error(err)\n    process.exit(1)\n  }\n}\n","import { FastifyPluginCallback } from 'fastify'\n\nexport function createFastifyPlugin(cb: FastifyPluginCallback) {\n  return cb;\n}\n","import { createFastifyPlugin } from '../plugin.ts'\n\nexport const healthPlugin = createFastifyPlugin((app) => {\n  app.get('/v1/health', {\n    schema: {\n      tags: ['health'],\n    },\n    handler: async () => {\n      return {\n        status: 200,\n        message: 'ok',\n      }\n    },\n  })\n})\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../lib/fastify.ts","../lib/plugin.ts","../lib/plugins/healthPlugin.ts"],"sourcesContent":["import Fastify, {\n  FastifyBaseLogger,\n  FastifyContextConfig,\n  FastifyInstance,\n  FastifyReply,\n  FastifyServerOptions,\n  RawServerDefault,\n} from 'fastify'\nimport type { FastifyRequest } from 'fastify'\nimport {\n  serializerCompiler,\n  validatorCompiler,\n  ZodTypeProvider,\n} from 'fastify-type-provider-zod'\nimport fastifyRateLimit, { RateLimitPluginOptions } from '@fastify/rate-limit'\nimport fastifyJwt, { FastifyJWTOptions } from '@fastify/jwt'\nimport fastifySwagger, { SwaggerOptions } from '@fastify/swagger'\nimport fastifySwaggerUI, { FastifySwaggerUiOptions } from '@fastify/swagger-ui'\nimport { IncomingMessage, ServerResponse } from 'node:http'\n\nexport type JWTAuthorizationHandler = <TUser = unknown>(\n  request: FastifyRequest,\n  reply: FastifyReply,\n  user: TUser\n) => Promise<boolean> | boolean\n\nexport interface JWTRouteConfig {\n  jwt?:\n    | boolean // true = require JWT, false = bypass JWT\n    | {\n        required?: boolean // Default: true if global enabled\n        authorize?: JWTAuthorizationHandler // Check JWT info before route processing\n      }\n}\n\n// Extend Fastify types to include custom config\ndeclare module 'fastify' {\n  interface FastifyContextConfig {\n    jwt?:\n      | boolean\n      | {\n          required?: boolean\n          authorize?: JWTAuthorizationHandler\n        }\n  }\n}\n\nexport interface CreateFastifyOptions {\n  logger?: FastifyServerOptions['loggerInstance'],\n  rateLimit?: {\n    global?: RateLimitPluginOptions\n  }\n  jwt?: {\n    secret: string\n    sign?: FastifyJWTOptions['sign']\n    verify?: FastifyJWTOptions['verify']\n    global?: boolean // Enable JWT check globally for all routes\n  }\n  swagger?: {\n    title: string\n    version: string\n    description: string\n    routePrefix?: string\n  }\n}\n\nexport type FastifyServer = FastifyInstance<\n  RawServerDefault,\n  IncomingMessage,\n  ServerResponse,\n  FastifyBaseLogger,\n  ZodTypeProvider\n> & FastifyContextConfig\n\nexport async function createFastify(options?: CreateFastifyOptions): Promise<FastifyServer> {\n  const fastifyOptions: FastifyServerOptions = {}\n\n  if (options?.logger) {\n    fastifyOptions.loggerInstance = options.logger\n  }\n\n  const fastify = Fastify(fastifyOptions).withTypeProvider<ZodTypeProvider>()\n\n  // Set up Zod validation and serialization\n  fastify.setValidatorCompiler(validatorCompiler)\n  fastify.setSerializerCompiler(serializerCompiler)\n\n  // Store Swagger route prefix for JWT bypass logic\n  let swaggerRoutePrefix: string | undefined\n\n  // Register Swagger first to capture all routes with Zod schemas\n  if (options?.swagger) {\n    await fastify.register(fastifySwagger, {\n      openapi: {\n        info: {\n          title: options.swagger.title,\n          version: options.swagger.version,\n          description: options.swagger.description,\n        },\n      },\n    } as SwaggerOptions)\n\n    let routePrefix = options.swagger.routePrefix || '/docs/'\n\n    if (!routePrefix.startsWith('/')) {\n      routePrefix = '/' + routePrefix\n    }\n\n    if (!routePrefix.endsWith('/')) {\n      routePrefix = routePrefix + '/'\n    }\n\n    swaggerRoutePrefix = routePrefix\n    await fastify.register(fastifySwaggerUI, { routePrefix } as FastifySwaggerUiOptions)\n  }\n\n  // Register JWT authentication\n  if (options?.jwt) {\n    const jwtOptions: FastifyJWTOptions = {\n      secret: options.jwt.secret,\n    }\n    if (options.jwt.sign !== undefined) {\n      jwtOptions.sign = options.jwt.sign\n    }\n    if (options.jwt.verify !== undefined) {\n      jwtOptions.verify = options.jwt.verify\n    }\n    await fastify.register(fastifyJwt, jwtOptions)\n\n    // Global JWT checking hook\n    if (options.jwt.global) {\n      fastify.addHook('onRequest', async (request, reply) => {\n        // Skip JWT verification for Swagger documentation routes\n        if (swaggerRoutePrefix && request.url.startsWith(swaggerRoutePrefix)) {\n          return\n        }\n\n        const routeConfig = (request.routeOptions.config as JWTRouteConfig) || {}\n        const jwtConfig = routeConfig.jwt\n\n        // Check if route explicitly bypasses JWT\n        if (jwtConfig === false) {\n          return\n        }\n\n        // Check if route explicitly requires JWT or uses global setting\n        const shouldVerify =\n          jwtConfig === true ||\n          (typeof jwtConfig === 'object' && jwtConfig.required !== false) ||\n          (jwtConfig === undefined && options?.jwt?.global === true)\n\n        if (shouldVerify) {\n          try {\n            await request.jwtVerify()\n\n            // Custom authorization - check JWT info before route processing\n            if (typeof jwtConfig === 'object' && jwtConfig.authorize) {\n              const authorized = await jwtConfig.authorize(request, reply, request.user)\n              if (!authorized) {\n                reply.status(403).send({\n                  error: 'Forbidden',\n                  message: 'Authorization failed',\n                })\n                return\n              }\n            }\n          } catch (err) {\n            reply.status(401).send({\n              error: 'Unauthorized',\n              message: 'Invalid or missing JWT token',\n            })\n          }\n        }\n      })\n    }\n  }\n\n  // Register Rate Limiting\n  if (options?.rateLimit?.global) {\n    await fastify.register(fastifyRateLimit, {\n      global: true,\n      ...options.rateLimit.global,\n    })\n  }\n\n  return fastify\n}\n\nexport async function runFastify(fastify: FastifyServer, host: string, port: number) {\n  try {\n    await fastify.listen({ host, port })\n  } catch (err) {\n    fastify.log.error(err)\n    process.exit(1)\n  }\n}\n","import { FastifyPluginCallback } from 'fastify'\n\nexport function createFastifyPlugin(cb: FastifyPluginCallback) {\n  return cb;\n}\n","import { createFastifyPlugin } from '../plugin.ts'\n\nexport const healthPlugin = createFastifyPlugin((app) => {\n  app.get('/v1/health', {\n    schema: {\n      tags: ['health'],\n    },\n    handler: async () => {\n      return {\n        status: 200,\n        message: 'ok',\n      }\n    },\n  })\n})\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a_jackie_z/fastify",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "A collection of Fastify plugins and utilities for building robust web applications.",
   "license": "MIT",
   "author": "Sang Lu <connect.with.sang@gmail.com>",
@@ -24,10 +24,9 @@
     "@fastify/rate-limit": "^10.3.0",
     "@fastify/swagger": "^9.6.1",
     "@fastify/swagger-ui": "^5.2.4",
-    "@fastify/type-provider-typebox": "^6.1.0",
-    "@sinclair/typebox": "^0.34.47",
     "fastify": "^5.7.1",
-    "typebox": "^1.0.79"
+    "fastify-type-provider-zod": "^6.1.0",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/node": "^25.0.9",