@a_jackie_z/fastify 1.0.0 → 1.1.0

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
 
@@ -13,8 +13,8 @@ npm install @a_jackie_z/fastify
 ### Basic Setup
 
 ```typescript
-import { createFastify } from '@a_jackie_z/fastify'
-import { Type } from '@sinclair/typebox'
+import { createFastify, runFastify } from '@a_jackie_z/fastify'
+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(),
       }),
     },
   },
@@ -33,26 +33,31 @@ app.route({
   },
 })
 
-await app.listen({ port: 3000 })
+await runFastify(app, '0.0.0.0', 3000)
 ```
 
 ## Features
 
 - **JWT Authentication** - Built-in JWT support with global and route-level configuration
-- **Rate Limiting** - Flexible rate limiting at global and route levels
-- **Swagger Documentation** - Auto-generated API documentation with TypeBox schemas
-- **TypeBox Integration** - Type-safe request/response validation
-- **Logger Integration** - Uses `@a_jackie_z/logger` for consistent logging
+- **Rate Limiting** - Global rate limiting for API protection
+- **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
 
 ## Examples
 
 ### 1. Complete Setup with All Features
 
 ```typescript
-import { createFastify } from '@a_jackie_z/fastify'
-import { Type } from '@sinclair/typebox'
+import { createFastify, runFastify } from '@a_jackie_z/fastify'
+import { z } from 'zod'
 
 const app = await createFastify({
+  // Optional: Integrate your logger
+  // logger: yourFastifyLogger,
+  
   // Rate limiting
   rateLimit: {
     global: {
@@ -77,7 +82,7 @@ const app = await createFastify({
   },
 })
 
-await app.listen({ port: 3000 })
+await runFastify(app, '0.0.0.0', 3000)
 ```
 
 ### 2. Authentication Flow
@@ -92,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(),
       }),
     },
   },
@@ -135,8 +140,8 @@ app.route({
   },
   schema: {
     response: {
-      200: Type.Object({
-        message: Type.String(),
+      200: z.object({
+        message: z.string(),
       }),
     },
   },
@@ -155,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(),
       }),
     },
   },
@@ -186,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(),
       }),
     },
   },
@@ -216,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(),
       }),
     },
   },
@@ -259,61 +264,71 @@ app.route({
 })
 ```
 
-### 6. Rate Limiting
-
-#### Route-Specific Rate Limit
+### 6. Health Check Plugin
 
 ```typescript
-app.route({
-  method: 'GET',
-  url: '/limited',
-  config: {
-    rateLimit: {
-      max: 5,
-      timeWindow: '1 minute',
-    },
-  },
-  handler: async () => {
-    return { message: 'Strict rate limiting applied' }
-  },
-})
+import { createFastify, runFastify, healthPlugin } from '@a_jackie_z/fastify'
+
+const app = await createFastify()
+
+// Register health check plugin
+await app.register(healthPlugin)
+
+// Health endpoint available at: GET /v1/health
+// Response: { status: 200, message: 'ok' }
+
+await runFastify(app, '0.0.0.0', 3000)
 ```
 
-#### Disable Rate Limit for Specific Route
+### 7. Creating Custom Plugins
 
 ```typescript
-app.route({
-  method: 'GET',
-  url: '/unlimited',
-  config: {
-    rateLimit: false,
-  },
-  handler: async () => {
-    return { message: 'No rate limiting' }
-  },
+import { createFastify, runFastify, createFastifyPlugin } from '@a_jackie_z/fastify'
+import { z } from 'zod'
+
+// Create a reusable plugin
+const myPlugin = createFastifyPlugin((app) => {
+  app.get('/plugin-route', {
+    schema: {
+      response: {
+        200: z.object({
+          message: z.string(),
+        }),
+      },
+    },
+    handler: async () => {
+      return { message: 'From plugin' }
+    },
+  })
 })
+
+// Use the plugin
+const app = await createFastify()
+await app.register(myPlugin)
+
+await runFastify(app, '0.0.0.0', 3000)
 ```
 
-### 7. 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(),
       }),
     },
   },
@@ -334,6 +349,7 @@ app.route({
 
 ```typescript
 interface CreateFastifyOptions {
+  logger?: FastifyServerOptions['loggerInstance'],
   rateLimit?: {
     global?: RateLimitPluginOptions
   }
@@ -347,7 +363,7 @@ interface CreateFastifyOptions {
     title: string
     version: string
     description: string
-    routePrefix?: string // Default: '/documentation'
+    routePrefix?: string // Default: '/docs/'
   }
 }
 ```
@@ -371,6 +387,27 @@ type JWTAuthorizationHandler = (
 ) => Promise<boolean> | boolean
 ```
 
+## API Reference
+
+### `createFastify(options?: CreateFastifyOptions): Promise<FastifyServer>`
+
+Creates and configures a Fastify server instance with Zod support and optional plugins.
+
+### `runFastify(fastify: FastifyServer, host: string, port: number): Promise<void>`
+
+Starts the Fastify server. Handles errors and exits the process if the server fails to start.
+
+**Parameters:**
+- `fastify` - The Fastify server instance
+- `host` - The host to bind to (e.g., '0.0.0.0' or 'localhost')
+- `port` - The port number to listen on
+
+**Example:**
+```typescript
+const app = await createFastify()
+await runFastify(app, '0.0.0.0', 3000)
+```
+
 ## Usage Patterns
 
 ### Pattern 1: Global JWT with Selective Public Routes

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,8 @@ async function createFastify(options) {
     fastifyOptions.loggerInstance = options.logger;
   }
   const fastify = Fastify(fastifyOptions).withTypeProvider();
+  fastify.setValidatorCompiler(validatorCompiler);
+  fastify.setSerializerCompiler(serializerCompiler);
   if (options?.swagger) {
     await fastify.register(fastifySwagger, {
       openapi: {

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  // 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    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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a_jackie_z/fastify",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "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",