@a_jackie_z/fastify 1.1.4 → 1.1.6

package/README.md

@@ -13,7 +13,7 @@ npm install @a_jackie_z/fastify
 ### Basic Setup
 
 ```typescript
-import { createFastify, runFastify } from '@a_jackie_z/fastify'
+import { createFastify, runFastify, formatSuccess } from '@a_jackie_z/fastify'
 import { z } from 'zod'
 
 const app = await createFastify()
@@ -24,12 +24,16 @@ app.route({
   schema: {
     response: {
       200: z.object({
-        message: z.string(),
+        status: z.number(),
+        success: z.boolean(),
+        data: z.object({
+          message: z.string(),
+        }),
       }),
     },
   },
-  handler: async () => {
-    return { message: 'Hello World!' }
+  handler: async (_request, reply) => {
+    return reply.send(formatSuccess(200, { message: 'Hello World!' }))
   },
 })
 
@@ -40,8 +44,10 @@ 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 Zod schemas
+- **Swagger Documentation** - Auto-generated API documentation with Zod schemas and bearer authentication
 - **Zod Integration** - Type-safe request/response validation
+- **Standardized Response Formatting** - Consistent response shapes with `formatSuccess` and `formatError` utilities
+- **Automatic Error Handling** - Field-level validation errors, auth errors, and rate limit errors with consistent formatting
 - **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
@@ -90,6 +96,8 @@ await runFastify(app, '0.0.0.0', 3000)
 #### Login Route (Public)
 
 ```typescript
+import { formatSuccess, formatError } from '@a_jackie_z/fastify'
+
 app.route({
   method: 'POST',
   url: '/auth/login',
@@ -103,10 +111,17 @@ app.route({
     }),
     response: {
       200: z.object({
-        token: z.string(),
+        status: z.number(),
+        success: z.boolean(),
+        data: z.object({
+          token: z.string(),
+        }),
       }),
       401: z.object({
+        status: z.number(),
+        success: z.boolean(),
         error: z.string(),
+        message: z.string(),
       }),
     },
   },
@@ -120,11 +135,12 @@ app.route({
         role: 'admin',
         permissions: ['read', 'write', 'delete'],
       })
-      return { token }
+      return reply.send(formatSuccess(200, { token }))
     }
 
-    reply.status(401)
-    return { error: 'Invalid credentials' }
+    return reply.status(401).send(
+      formatError(401, 'Unauthorized', 'Invalid credentials')
+    )
   },
 })
 ```
@@ -343,6 +359,133 @@ app.route({
 })
 ```
 
+### 9. Response Formatting
+
+All responses should follow a consistent format using the provided utility functions:
+
+#### Success Response Format
+
+```typescript
+import { formatSuccess } from '@a_jackie_z/fastify'
+
+app.route({
+  method: 'GET',
+  url: '/users/:id',
+  schema: {
+    params: z.object({
+      id: z.string(),
+    }),
+    response: {
+      200: z.object({
+        status: z.number(),
+        success: z.boolean(),
+        data: z.object({
+          id: z.string(),
+          name: z.string(),
+          email: z.string(),
+        }),
+      }),
+    },
+  },
+  handler: async (request, reply) => {
+    const { id } = request.params
+    const user = await findUser(id) // Your logic here
+    
+    return reply.status(200).send(
+      formatSuccess(200, user)
+    )
+    // Returns: { status: 200, success: true, data: { id, name, email } }
+  },
+})
+```
+
+#### Error Response Format
+
+```typescript
+import { formatError } from '@a_jackie_z/fastify'
+
+app.route({
+  method: 'DELETE',
+  url: '/users/:id',
+  handler: async (request, reply) => {
+    const { id } = request.params
+    
+    const user = await findUser(id)
+    if (!user) {
+      return reply.status(404).send(
+        formatError(404, 'Not Found', `User with ID ${id} not found`)
+      )
+      // Returns: { status: 404, success: false, error: 'Not Found', message: '...' }
+    }
+    
+    await deleteUser(id)
+    return reply.send(formatSuccess(200, { message: 'User deleted' }))
+  },
+})
+```
+
+#### Automatic Validation Error Formatting
+
+Validation errors are automatically formatted with field-level details:
+
+```typescript
+app.route({
+  method: 'POST',
+  url: '/users',
+  config: { jwt: false },
+  schema: {
+    body: z.object({
+      username: z.string().min(3, 'Username must be at least 3 characters'),
+      email: z.string().email('Invalid email format'),
+      age: z.number().int().min(18, 'Must be at least 18 years old'),
+    }),
+  },
+  handler: async (request, reply) => {
+    // If validation fails, automatic error response:
+    // {
+    //   status: 400,
+    //   success: false,
+    //   error: 'Validation Error',
+    //   message: 'Request validation failed',
+    //   details: [
+    //     { field: 'username', message: 'Username must be at least 3 characters' },
+    //     { field: 'email', message: 'Invalid email format' },
+    //     { field: 'age', message: 'Must be at least 18 years old' }
+    //   ]
+    // }
+    
+    return reply.send(formatSuccess(200, request.body))
+  },
+})
+```
+
+#### Automatic Error Handling
+
+All errors follow the standardized format automatically:
+
+- **Validation Errors (400)**: Field-level details with field name and message
+- **Authentication Errors (401)**: JWT token missing or invalid
+- **Authorization Errors (403)**: Insufficient permissions
+- **Not Found Errors (404)**: Resource not found
+- **Rate Limit Errors (429)**: Too many requests
+- **Server Errors (500)**: Internal server errors
+
+All errors are automatically logged via `fastify.log.error` with request context.
+
+```typescript
+// Authentication error (automatic)
+// GET /protected without JWT token
+// { status: 401, success: false, error: 'Unauthorized', message: 'Invalid or missing JWT token' }
+
+// Authorization error (automatic)
+// GET /admin without admin role
+// { status: 403, success: false, error: 'Forbidden', message: 'Authorization failed' }
+
+// Rate limit error (automatic)
+// Too many requests
+// { status: 429, success: false, error: 'Too Many Requests', message: 'Rate limit exceeded' }
+```
+
 ## Configuration Options
 
 ### `CreateFastifyOptions`
@@ -409,6 +552,145 @@ const app = await createFastify()
 await runFastify(app, '0.0.0.0', 3000)
 ```
 
+### Response Formatting Functions
+
+#### `formatSuccess<T>(status: number, data: T): SuccessResponse<T>`
+
+Creates a standardized success response.
+
+**Parameters:**
+- `status` - HTTP status code (e.g., 200, 201)
+- `data` - Response data of any type
+
+**Returns:** `SuccessResponse<T>`
+```typescript
+{
+  status: number
+  success: true
+  data: T
+}
+```
+
+**Example:**
+```typescript
+return reply.send(formatSuccess(200, { id: '123', name: 'John' }))
+// Returns: { status: 200, success: true, data: { id: '123', name: 'John' } }
+```
+
+#### `formatError(status: number, error: string, message: string, details?: ValidationDetail[]): ErrorResponse`
+
+Creates a standardized error response.
+
+**Parameters:**
+- `status` - HTTP status code (e.g., 400, 404, 500)
+- `error` - Error type/name (e.g., 'Not Found', 'Validation Error')
+- `message` - Human-readable error message
+- `details` - Optional array of validation error details
+
+**Returns:** `ErrorResponse`
+```typescript
+{
+  status: number
+  success: false
+  error: string
+  message: string
+  details?: ValidationDetail[]
+}
+```
+
+**Example:**
+```typescript
+return reply.status(404).send(
+  formatError(404, 'Not Found', 'User not found')
+)
+// Returns: { status: 404, success: false, error: 'Not Found', message: 'User not found' }
+```
+
+### Response Type Interfaces
+
+#### `SuccessResponse<T>`
+```typescript
+interface SuccessResponse<T> {
+  status: number
+  success: true
+  data: T
+}
+```
+
+#### `ErrorResponse`
+```typescript
+interface ErrorResponse {
+  status: number
+  success: false
+  error: string
+  message: string
+  details?: ValidationDetail[]
+}
+```
+
+#### `ValidationDetail`
+```typescript
+interface ValidationDetail {
+  field: string
+  message: string
+}
+```
+
+### Zod Schema Helpers
+
+For defining response schemas with Zod validation:
+
+#### `successResponseSchema<T>(dataSchema: T): ZodObject`
+
+Creates a Zod schema for standardized success responses.
+
+**Parameters:**
+- `dataSchema` - Zod schema for the data payload
+
+**Returns:** Zod object schema matching `SuccessResponse<T>`
+
+**Example:**
+```typescript
+import { z } from 'zod'
+import { successResponseSchema } from '@a_jackie_z/fastify'
+
+const userSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+})
+
+const loginResponseSchema = {
+  body: z.object({
+    username: z.string(),
+    password: z.string(),
+  }),
+  response: {
+    200: successResponseSchema(z.object({
+      accessToken: z.string(),
+      refreshToken: z.string(),
+    })),
+  },
+}
+```
+
+#### `errorResponseSchema: ZodObject`
+
+Zod schema for standardized error responses. Matches `ErrorResponse` interface.
+
+**Example:**
+```typescript
+import { errorResponseSchema } from '@a_jackie_z/fastify'
+
+const myRouteSchema = {
+  response: {
+    200: successResponseSchema(z.object({ success: z.boolean() })),
+    400: errorResponseSchema,
+    401: errorResponseSchema,
+    404: errorResponseSchema,
+  },
+}
+```
+
 ## Fastify JWT Service
 
 A typed helper for issuing and verifying access/refresh tokens alongside the Fastify JWT plugin.

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as fastify from 'fastify';
 import { FastifyRequest, FastifyReply, FastifyServerOptions, FastifyInstance, RawServerDefault, FastifyBaseLogger, FastifyContextConfig, FastifyPluginCallback } from 'fastify';
 export { FastifyReply, FastifyRequest } from 'fastify';
-import { ZodTypeProvider } from 'fastify-type-provider-zod';
-export * from 'fastify-type-provider-zod';
 import { RateLimitPluginOptions } from '@fastify/rate-limit';
 import { FastifyJWTOptions } from '@fastify/jwt';
+import { ZodTypeProvider } from 'fastify-type-provider-zod';
+export * from 'fastify-type-provider-zod';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { z } from 'zod';
 
@@ -42,6 +42,41 @@ interface CreateFastifyOptions {
     };
 }
 type FastifyServer = FastifyInstance<RawServerDefault, IncomingMessage, ServerResponse, FastifyBaseLogger, ZodTypeProvider> & FastifyContextConfig;
+
+interface ValidationDetail {
+    field: string;
+    message: string;
+}
+interface SuccessResponse<T> {
+    status: number;
+    success: true;
+    data: T;
+}
+interface ErrorResponse {
+    status: number;
+    success: false;
+    error: string;
+    message: string;
+    details?: ValidationDetail[];
+}
+declare function formatSuccess<T>(status: number, data: T): SuccessResponse<T>;
+declare function formatError(status: number, error: string, message: string, details?: ValidationDetail[]): ErrorResponse;
+declare const successResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    status: z.ZodNumber;
+    success: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strip>;
+declare const errorResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    success: z.ZodLiteral<false>;
+    error: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+
 declare function createFastify(options?: CreateFastifyOptions): Promise<FastifyServer>;
 declare function runFastify(fastify: FastifyServer, host: string, port: number): Promise<void>;
 
@@ -155,4 +190,4 @@ declare function createFastifyPlugin(cb: FastifyPluginCallback): (fastify: Fasti
 
 declare const healthPlugin: (fastify: FastifyServer, options: Parameters<fastify.FastifyPluginCallback>[1], done: Parameters<fastify.FastifyPluginCallback>[2]) => void;
 
-export { type BaseAccessTokenPayload, type BaseRefreshTokenPayload, type CreateFastifyOptions, FastifyJwtService, type FastifyJwtServiceOptions, type FastifyServer, type JWTAuthorizationHandler, type JWTRouteConfig, type TokenPair, baseAccessTokenPayloadSchema, baseRefreshTokenPayloadSchema, createFastify, createFastifyPlugin, healthPlugin, runFastify };
+export { type BaseAccessTokenPayload, type BaseRefreshTokenPayload, type CreateFastifyOptions, type ErrorResponse, FastifyJwtService, type FastifyJwtServiceOptions, type FastifyServer, type JWTAuthorizationHandler, type JWTRouteConfig, type SuccessResponse, type TokenPair, type ValidationDetail, baseAccessTokenPayloadSchema, baseRefreshTokenPayloadSchema, createFastify, createFastifyPlugin, errorResponseSchema, formatError, formatSuccess, healthPlugin, runFastify, successResponseSchema };

package/dist/index.js

@@ -1,87 +1,223 @@
 // lib/fastify.ts
 import Fastify from "fastify";
-import {
-  serializerCompiler,
-  validatorCompiler
-} from "fastify-type-provider-zod";
+import { serializerCompiler, validatorCompiler } from "fastify-type-provider-zod";
 import fastifyRateLimit from "@fastify/rate-limit";
-import fastifyJwt from "@fastify/jwt";
+
+// lib/response.ts
+import { z } from "zod";
+function formatSuccess(status, data) {
+  return {
+    status,
+    success: true,
+    data
+  };
+}
+function formatError(status, error, message, details) {
+  const response = {
+    status,
+    success: false,
+    error,
+    message
+  };
+  if (details && details.length > 0) {
+    response.details = details;
+  }
+  return response;
+}
+var successResponseSchema = (dataSchema) => z.object({
+  status: z.number(),
+  success: z.literal(true),
+  data: dataSchema
+});
+var errorResponseSchema = z.object({
+  status: z.number(),
+  success: z.literal(false),
+  error: z.string(),
+  message: z.string(),
+  details: z.array(z.object({
+    field: z.string(),
+    message: z.string()
+  })).optional()
+});
+
+// lib/error-handler.ts
+function setupErrorHandler(fastify) {
+  fastify.setErrorHandler((error, request, reply) => {
+    fastify.log.error({
+      err: error,
+      url: request.url,
+      method: request.method
+    }, "Request error");
+    if (error.validation) {
+      const details = error.validation.map((issue) => {
+        const field = issue.instancePath || issue.dataPath || issue.params?.missingProperty || "unknown";
+        const cleanField = field.startsWith("/") ? field.slice(1).replace(/\//g, ".") : field;
+        return {
+          field: cleanField || "unknown",
+          message: issue.message || "Validation failed"
+        };
+      });
+      return reply.status(400).send(
+        formatError(400, "Validation Error", "Request validation failed", details)
+      );
+    }
+    if (error.statusCode === 429) {
+      return reply.status(429).send(
+        formatError(429, "Too Many Requests", "Rate limit exceeded")
+      );
+    }
+    if (error.statusCode === 401) {
+      return reply.status(401).send(
+        formatError(401, "Unauthorized", error.message || "Authentication required")
+      );
+    }
+    if (error.statusCode === 403) {
+      return reply.status(403).send(
+        formatError(403, "Forbidden", error.message || "Access denied")
+      );
+    }
+    if (error.statusCode === 404) {
+      return reply.status(404).send(
+        formatError(404, "Not Found", error.message || "Resource not found")
+      );
+    }
+    const statusCode = error.statusCode || 500;
+    return reply.status(statusCode).send(
+      formatError(
+        statusCode,
+        statusCode === 500 ? "Internal Server Error" : error.name || "Error",
+        error.message || "An unexpected error occurred"
+      )
+    );
+  });
+}
+
+// lib/swagger-setup.ts
 import fastifySwagger from "@fastify/swagger";
 import fastifySwaggerUI from "@fastify/swagger-ui";
-async function createFastify(options) {
-  const fastifyOptions = {};
-  if (options?.logger) {
-    fastifyOptions.loggerInstance = options.logger;
+import { jsonSchemaTransform } from "fastify-type-provider-zod";
+async function setupSwagger(fastify, options) {
+  if (!options.swagger) {
+    return void 0;
   }
-  const fastify = Fastify(fastifyOptions).withTypeProvider();
-  fastify.setValidatorCompiler(validatorCompiler);
-  fastify.setSerializerCompiler(serializerCompiler);
-  let swaggerRoutePrefix;
-  if (options?.swagger) {
-    await fastify.register(fastifySwagger, {
-      openapi: {
-        info: {
-          title: options.swagger.title,
-          version: options.swagger.version,
-          description: options.swagger.description
+  const openApiConfig = {
+    openapi: {
+      info: {
+        title: options.swagger.title,
+        version: options.swagger.version,
+        description: options.swagger.description
+      }
+    },
+    transform: jsonSchemaTransform
+  };
+  if (options.jwt) {
+    openApiConfig.openapi.components = {
+      securitySchemes: {
+        bearerAuth: {
+          type: "http",
+          scheme: "bearer",
+          bearerFormat: "JWT"
         }
       }
-    });
-    let routePrefix = options.swagger.routePrefix || "/docs/";
-    if (!routePrefix.startsWith("/")) {
-      routePrefix = "/" + routePrefix;
-    }
-    if (!routePrefix.endsWith("/")) {
-      routePrefix = routePrefix + "/";
-    }
-    swaggerRoutePrefix = routePrefix;
-    await fastify.register(fastifySwaggerUI, { routePrefix });
-  }
-  if (options?.jwt) {
-    const jwtOptions = {
-      secret: options.jwt.secret
     };
-    if (options.jwt.sign !== void 0) {
-      jwtOptions.sign = options.jwt.sign;
+  }
+  await fastify.register(fastifySwagger, openApiConfig);
+  let routePrefix = options.swagger.routePrefix || "/docs/";
+  if (!routePrefix.startsWith("/")) {
+    routePrefix = "/" + routePrefix;
+  }
+  if (!routePrefix.endsWith("/")) {
+    routePrefix = routePrefix + "/";
+  }
+  await fastify.register(fastifySwaggerUI, { routePrefix });
+  return routePrefix;
+}
+function setupSwaggerSecurityHook(fastify, options, swaggerRoutePrefix) {
+  if (!options.jwt || !options.swagger) {
+    return;
+  }
+  fastify.addHook("onRoute", (routeOptions) => {
+    if (swaggerRoutePrefix && routeOptions.url.startsWith(swaggerRoutePrefix)) {
+      return;
     }
-    if (options.jwt.verify !== void 0) {
-      jwtOptions.verify = options.jwt.verify;
+    const routeConfig = routeOptions.config || {};
+    const jwtConfig = routeConfig.jwt;
+    if (jwtConfig === false) {
+      return;
     }
-    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) {
-          return;
-        }
-        const shouldVerify = jwtConfig === true || typeof jwtConfig === "object" && jwtConfig.required !== false || jwtConfig === void 0 && options?.jwt?.global === true;
-        if (shouldVerify) {
-          try {
-            await request.jwtVerify();
-            if (typeof jwtConfig === "object" && jwtConfig.authorize) {
-              const authorized = await jwtConfig.authorize(request, reply, request.user);
-              if (!authorized) {
-                reply.status(403).send({
-                  error: "Forbidden",
-                  message: "Authorization failed"
-                });
-                return;
-              }
+    const requiresJWT = jwtConfig === true || typeof jwtConfig === "object" && jwtConfig.required !== false || jwtConfig === void 0 && options.jwt?.global === true;
+    if (requiresJWT) {
+      if (!routeOptions.schema) {
+        routeOptions.schema = {};
+      }
+      if (!routeOptions.schema.security) {
+        routeOptions.schema.security = [{ bearerAuth: [] }];
+      }
+    }
+  });
+}
+
+// lib/jwt-setup.ts
+import fastifyJwt from "@fastify/jwt";
+async function setupJWT(fastify, options, swaggerRoutePrefix) {
+  if (!options.jwt) {
+    return;
+  }
+  const jwtOptions = {
+    secret: options.jwt.secret
+  };
+  if (options.jwt.sign !== void 0) {
+    jwtOptions.sign = options.jwt.sign;
+  }
+  if (options.jwt.verify !== void 0) {
+    jwtOptions.verify = options.jwt.verify;
+  }
+  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) {
+        return;
+      }
+      const shouldVerify = jwtConfig === true || typeof jwtConfig === "object" && jwtConfig.required !== false || jwtConfig === void 0 && options.jwt?.global === true;
+      if (shouldVerify) {
+        try {
+          await request.jwtVerify();
+          if (typeof jwtConfig === "object" && jwtConfig.authorize) {
+            const authorized = await jwtConfig.authorize(request, reply, request.user);
+            if (!authorized) {
+              return reply.status(403).send(
+                formatError(403, "Forbidden", "Authorization failed")
+              );
             }
-          } catch (err) {
-            reply.status(401).send({
-              error: "Unauthorized",
-              message: "Invalid or missing JWT token"
-            });
           }
+        } catch (err) {
+          return reply.status(401).send(
+            formatError(401, "Unauthorized", "Invalid or missing JWT token")
+          );
         }
-      });
-    }
+      }
+    });
   }
+}
+
+// lib/fastify.ts
+async function createFastify(options) {
+  const fastifyOptions = {};
+  if (options?.logger) {
+    fastifyOptions.loggerInstance = options.logger;
+  }
+  const fastify = Fastify(fastifyOptions).withTypeProvider();
+  fastify.setValidatorCompiler(validatorCompiler);
+  fastify.setSerializerCompiler(serializerCompiler);
+  setupErrorHandler(fastify);
+  const swaggerRoutePrefix = await setupSwagger(fastify, options || {});
+  setupSwaggerSecurityHook(fastify, options || {}, swaggerRoutePrefix);
+  await setupJWT(fastify, options || {}, swaggerRoutePrefix);
   if (options?.rateLimit?.global) {
     await fastify.register(fastifyRateLimit, {
       global: true,
@@ -100,16 +236,16 @@ async function runFastify(fastify, host, port) {
 }
 
 // lib/jwt.service.ts
-import { z } from "zod";
-var baseAccessTokenPayloadSchema = z.object({
-  identityId: z.string(),
-  type: z.literal("access"),
-  exp: z.number()
+import { z as z2 } from "zod";
+var baseAccessTokenPayloadSchema = z2.object({
+  identityId: z2.string(),
+  type: z2.literal("access"),
+  exp: z2.number()
 });
-var baseRefreshTokenPayloadSchema = z.object({
-  identityId: z.string(),
-  type: z.literal("refresh"),
-  exp: z.number()
+var baseRefreshTokenPayloadSchema = z2.object({
+  identityId: z2.string(),
+  type: z2.literal("refresh"),
+  exp: z2.number()
 });
 var FastifyJwtService = class {
   constructor(app, options) {
@@ -172,7 +308,7 @@ var FastifyJwtService = class {
       }
       return validated;
     } catch (error) {
-      if (error instanceof z.ZodError) {
+      if (error instanceof z2.ZodError) {
         throw new Error("Invalid token payload");
       }
       throw error;
@@ -190,7 +326,7 @@ var FastifyJwtService = class {
       }
       return validated;
     } catch (error) {
-      if (error instanceof z.ZodError) {
+      if (error instanceof z2.ZodError) {
         throw new Error("Invalid token payload");
       }
       throw error;
@@ -277,7 +413,11 @@ export {
   baseRefreshTokenPayloadSchema,
   createFastify,
   createFastifyPlugin,
+  errorResponseSchema,
+  formatError,
+  formatSuccess,
   healthPlugin,
-  runFastify
+  runFastify,
+  successResponseSchema
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../lib/fastify.ts","../lib/jwt.service.ts","../lib/plugin.ts","../lib/plugins/healthPlugin.ts","../index.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 { z } from 'zod'\nimport { FastifyServer } from './fastify.ts'\n\n/**\n * Base access token payload schema\n */\nexport const baseAccessTokenPayloadSchema = z.object({\n  identityId: z.string(),\n  type: z.literal('access'),\n  exp: z.number(),\n})\n\n/**\n * Base refresh token payload schema\n */\nexport const baseRefreshTokenPayloadSchema = z.object({\n  identityId: z.string(),\n  type: z.literal('refresh'),\n  exp: z.number(),\n})\n\n/**\n * Inferred types from base schemas\n */\nexport type BaseAccessTokenPayload = z.infer<typeof baseAccessTokenPayloadSchema>\nexport type BaseRefreshTokenPayload = z.infer<typeof baseRefreshTokenPayloadSchema>\n\n/**\n * Token pair interface\n */\nexport interface TokenPair {\n  accessToken: string\n  refreshToken: string\n}\n\n/**\n * FastifyJwtService configuration options\n */\nexport interface FastifyJwtServiceOptions {\n  accessTokenExpiry: string\n  refreshTokenExpiry: string\n  renewalThreshold: string\n  accessTokenSchema?: z.ZodSchema\n  refreshTokenSchema?: z.ZodSchema\n}\n\n/**\n * Generic JWT service for Fastify applications\n *\n * @template TAccess - Access token payload type extending BaseAccessTokenPayload\n * @template TRefresh - Refresh token payload type extending BaseRefreshTokenPayload\n *\n * @example\n * // Using base schemas\n * const jwtService = new FastifyJwtService(app, {\n *   accessTokenExpiry: '15m',\n *   refreshTokenExpiry: '7d',\n *   renewalThreshold: '1d',\n * })\n *\n * @example\n * // Using extended schemas\n * const customAccessSchema = baseAccessTokenPayloadSchema.extend({\n *   roles: z.array(z.string())\n * })\n * const jwtService = new FastifyJwtService(app, {\n *   accessTokenExpiry: '15m',\n *   refreshTokenExpiry: '7d',\n *   renewalThreshold: '1d',\n *   accessTokenSchema: customAccessSchema,\n * })\n */\nexport class FastifyJwtService<\n  TAccess extends BaseAccessTokenPayload = BaseAccessTokenPayload,\n  TRefresh extends BaseRefreshTokenPayload = BaseRefreshTokenPayload\n> {\n  private readonly accessTokenExpiry: string\n  private readonly refreshTokenExpiry: string\n  private readonly renewalThreshold: string\n  private readonly accessTokenSchema: z.ZodSchema<TAccess>\n  private readonly refreshTokenSchema: z.ZodSchema<TRefresh>\n\n  constructor(\n    private readonly app: FastifyServer,\n    options: FastifyJwtServiceOptions\n  ) {\n    this.accessTokenExpiry = options.accessTokenExpiry\n    this.refreshTokenExpiry = options.refreshTokenExpiry\n    this.renewalThreshold = options.renewalThreshold\n    this.accessTokenSchema = (options.accessTokenSchema ?? baseAccessTokenPayloadSchema) as z.ZodSchema<TAccess>\n    this.refreshTokenSchema = (options.refreshTokenSchema ?? baseRefreshTokenPayloadSchema) as z.ZodSchema<TRefresh>\n  }\n\n  /**\n   * Generate an access token for the given identity\n   */\n  generateAccessToken(identityId: string, extraPayload?: Partial<Omit<TAccess, 'identityId' | 'type' | 'exp'>>): string {\n    const payload = {\n      identityId,\n      type: 'access' as const,\n      ...extraPayload,\n    }\n\n    return this.app.jwt.sign(payload, {\n      expiresIn: this.accessTokenExpiry,\n    })\n  }\n\n  /**\n   * Generate a refresh token for the given identity\n   */\n  generateRefreshToken(identityId: string, extraPayload?: Partial<Omit<TRefresh, 'identityId' | 'type' | 'exp'>>): string {\n    const payload = {\n      identityId,\n      type: 'refresh' as const,\n      ...extraPayload,\n    }\n\n    return this.app.jwt.sign(payload, {\n      expiresIn: this.refreshTokenExpiry,\n    })\n  }\n\n  /**\n   * Generate both access and refresh tokens\n   */\n  generateTokenPair(identityId: string): TokenPair {\n    return {\n      accessToken: this.generateAccessToken(identityId),\n      refreshToken: this.generateRefreshToken(identityId),\n    }\n  }\n\n  /**\n   * Verify and decode an access token\n   */\n  verifyAccessToken(token: string): TAccess {\n    try {\n      const payload = this.app.jwt.verify(token) as unknown\n      const validated = this.accessTokenSchema.parse(payload)\n\n      if (validated.type !== 'access') {\n        throw new Error('Invalid token type')\n      }\n\n      return validated\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        throw new Error('Invalid token payload')\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Verify and decode a refresh token\n   */\n  verifyRefreshToken(token: string): TRefresh {\n    try {\n      const payload = this.app.jwt.verify(token) as unknown\n      const validated = this.refreshTokenSchema.parse(payload)\n\n      if (validated.type !== 'refresh') {\n        throw new Error('Invalid token type')\n      }\n\n      return validated\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        throw new Error('Invalid token payload')\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Renew a refresh token for the given identity\n   */\n  renewRefreshToken(identityId: string): string {\n    return this.generateRefreshToken(identityId)\n  }\n\n  /**\n   * Check if a refresh token should be renewed based on its expiry\n   */\n  shouldRenewRefreshToken(exp: number): boolean {\n    const now = Math.floor(Date.now() / 1000)\n    const threshold = this.parseTimespan(this.renewalThreshold)\n    return (exp - now) < threshold\n  }\n\n  /**\n   * Parse timespan string to seconds\n   */\n  private parseTimespan(timespan: string): number {\n    const match = timespan.match(/^(\\d+)([smhd])$/)\n    if (!match || !match[1] || !match[2]) {\n      throw new Error(`Invalid timespan format: ${timespan}`)\n    }\n\n    const value = parseInt(match[1]!, 10)\n    const unit = match[2]!\n\n    switch (unit) {\n      case 's':\n        return value\n      case 'm':\n        return value * 60\n      case 'h':\n        return value * 3600\n      case 'd':\n        return value * 86400\n      default:\n        throw new Error(`Unknown timespan unit: ${unit}`)\n    }\n  }\n}\n","import { FastifyPluginCallback } from 'fastify'\nimport { FastifyServer } from './fastify.ts'\nimport { ZodTypeProvider } from 'fastify-type-provider-zod'\n\nexport function createFastifyPlugin(cb: FastifyPluginCallback) {\n  return function createFastifyPluginWrapper(\n    fastify: FastifyServer,\n    options: Parameters<FastifyPluginCallback>[1],\n    done: Parameters<FastifyPluginCallback>[2],\n  ) {\n    const server = fastify.withTypeProvider<ZodTypeProvider>()\n    let doneCalled = false\n\n    const doneWrapper = (err?: Error) => {\n      done(err)\n      doneCalled = true\n    }\n\n    cb(server, options, doneWrapper)\n\n    if (!doneCalled) {\n      done()\n    }\n  }\n}\n","import { createFastifyPlugin } from '../plugin.ts'\nimport { FastifyServer } from '../fastify.ts'\n\nexport const healthPlugin = createFastifyPlugin((app: FastifyServer) => {\n  app.get('/v1/health', {\n    schema: {\n      tags: ['health'],\n    },\n    config: {\n      jwt: false,\n    },\n    handler: async () => {\n      return {\n        status: 200,\n        message: 'ok',\n      }\n    },\n  })\n})\n","export * from './lib/fastify.ts'\nexport * from './lib/jwt.service.ts'\nexport * from './lib/plugin.ts'\nexport * from './lib/plugins/healthPlugin.ts'\nexport * from 'fastify-type-provider-zod'\nexport type {\n  FastifyRequest,\n  FastifyReply,\n} from 'fastify'\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../lib/fastify.ts","../lib/response.ts","../lib/error-handler.ts","../lib/swagger-setup.ts","../lib/jwt-setup.ts","../lib/jwt.service.ts","../lib/plugin.ts","../lib/plugins/healthPlugin.ts","../index.ts"],"sourcesContent":["import Fastify, { FastifyServerOptions } from 'fastify'\nimport { serializerCompiler, validatorCompiler, ZodTypeProvider } from 'fastify-type-provider-zod'\nimport fastifyRateLimit from '@fastify/rate-limit'\nimport { setupErrorHandler } from './error-handler.ts'\nimport { setupSwagger, setupSwaggerSecurityHook } from './swagger-setup.ts'\nimport { setupJWT } from './jwt-setup.ts'\nimport type { CreateFastifyOptions, FastifyServer } from './types.ts'\n\n// Re-export types and utilities from other modules\nexport * from './response.ts'\nexport * from './types.ts'\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  // Set up error handler for standardized error responses\n  setupErrorHandler(fastify)\n\n  // Register Swagger first to capture all routes with Zod schemas\n  const swaggerRoutePrefix = await setupSwagger(fastify, options || {})\n\n  // Auto-inject security requirements for JWT-protected routes\n  setupSwaggerSecurityHook(fastify, options || {}, swaggerRoutePrefix)\n\n  // Register JWT authentication\n  await setupJWT(fastify, options || {}, swaggerRoutePrefix)\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 { z } from 'zod'\n\n// Response Types\nexport interface ValidationDetail {\n  field: string\n  message: string\n}\n\nexport interface SuccessResponse<T> {\n  status: number\n  success: true\n  data: T\n}\n\nexport interface ErrorResponse {\n  status: number\n  success: false\n  error: string\n  message: string\n  details?: ValidationDetail[]\n}\n\n// Response Formatters\nexport function formatSuccess<T>(status: number, data: T): SuccessResponse<T> {\n  return {\n    status,\n    success: true,\n    data,\n  }\n}\n\nexport function formatError(\n  status: number,\n  error: string,\n  message: string,\n  details?: ValidationDetail[]\n): ErrorResponse {\n  const response: ErrorResponse = {\n    status,\n    success: false,\n    error,\n    message,\n  }\n  if (details && details.length > 0) {\n    response.details = details\n  }\n  return response\n}\n\n// Zod Schema Helpers for Standardized Responses\nexport const successResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) => z.object({\n  status: z.number(),\n  success: z.literal(true),\n  data: dataSchema,\n})\n\nexport const errorResponseSchema = z.object({\n  status: z.number(),\n  success: z.literal(false),\n  error: z.string(),\n  message: z.string(),\n  details: z.array(z.object({\n    field: z.string(),\n    message: z.string(),\n  })).optional(),\n})\n","import type { FastifyError, FastifyInstance } from 'fastify'\nimport { formatError, type ValidationDetail } from './response.ts'\n\nexport function setupErrorHandler(fastify: FastifyInstance): void {\n  fastify.setErrorHandler((error: FastifyError, request, reply) => {\n    // Log all errors\n    fastify.log.error({\n      err: error,\n      url: request.url,\n      method: request.method,\n    }, 'Request error')\n\n    // Handle Zod validation errors\n    if (error.validation) {\n      const details: ValidationDetail[] = error.validation.map((issue: any) => {\n        // Build field path from dataPath or instancePath\n        const field = issue.instancePath || issue.dataPath || issue.params?.missingProperty || 'unknown'\n        const cleanField = field.startsWith('/') ? field.slice(1).replace(/\\//g, '.') : field\n\n        return {\n          field: cleanField || 'unknown',\n          message: issue.message || 'Validation failed',\n        }\n      })\n\n      return reply.status(400).send(\n        formatError(400, 'Validation Error', 'Request validation failed', details)\n      )\n    }\n\n    // Handle rate limit errors\n    if (error.statusCode === 429) {\n      return reply.status(429).send(\n        formatError(429, 'Too Many Requests', 'Rate limit exceeded')\n      )\n    }\n\n    // Handle authentication errors\n    if (error.statusCode === 401) {\n      return reply.status(401).send(\n        formatError(401, 'Unauthorized', error.message || 'Authentication required')\n      )\n    }\n\n    // Handle authorization errors\n    if (error.statusCode === 403) {\n      return reply.status(403).send(\n        formatError(403, 'Forbidden', error.message || 'Access denied')\n      )\n    }\n\n    // Handle not found errors\n    if (error.statusCode === 404) {\n      return reply.status(404).send(\n        formatError(404, 'Not Found', error.message || 'Resource not found')\n      )\n    }\n\n    // Handle all other errors as internal server errors\n    const statusCode = error.statusCode || 500\n    return reply.status(statusCode).send(\n      formatError(\n        statusCode,\n        statusCode === 500 ? 'Internal Server Error' : error.name || 'Error',\n        error.message || 'An unexpected error occurred'\n      )\n    )\n  })\n}\n","import type { FastifyInstance } from 'fastify'\nimport fastifySwagger, { SwaggerOptions } from '@fastify/swagger'\nimport fastifySwaggerUI, { FastifySwaggerUiOptions } from '@fastify/swagger-ui'\nimport { jsonSchemaTransform } from 'fastify-type-provider-zod'\nimport type { CreateFastifyOptions, JWTRouteConfig } from './types.ts'\n\nexport async function setupSwagger(\n  fastify: FastifyInstance,\n  options: CreateFastifyOptions\n): Promise<string | undefined> {\n  if (!options.swagger) {\n    return undefined\n  }\n\n  const openApiConfig: any = {\n    openapi: {\n      info: {\n        title: options.swagger.title,\n        version: options.swagger.version,\n        description: options.swagger.description,\n      },\n    },\n    transform: jsonSchemaTransform,\n  }\n\n  // Add bearer auth security scheme if JWT is enabled\n  if (options.jwt) {\n    openApiConfig.openapi.components = {\n      securitySchemes: {\n        bearerAuth: {\n          type: 'http',\n          scheme: 'bearer',\n          bearerFormat: 'JWT',\n        },\n      },\n    }\n  }\n\n  await fastify.register(fastifySwagger, openApiConfig 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  return routePrefix\n}\n\nexport function setupSwaggerSecurityHook(\n  fastify: FastifyInstance,\n  options: CreateFastifyOptions,\n  swaggerRoutePrefix: string | undefined\n): void {\n  if (!options.jwt || !options.swagger) {\n    return\n  }\n\n  // Auto-inject security requirements for JWT-protected routes\n  fastify.addHook('onRoute', (routeOptions) => {\n    // Skip Swagger routes\n    if (swaggerRoutePrefix && routeOptions.url.startsWith(swaggerRoutePrefix)) {\n      return\n    }\n\n    const routeConfig = (routeOptions.config as JWTRouteConfig) || {}\n    const jwtConfig = routeConfig.jwt\n\n    // Skip if JWT is explicitly bypassed\n    if (jwtConfig === false) {\n      return\n    }\n\n    // Determine if route requires JWT\n    const requiresJWT =\n      jwtConfig === true ||\n      (typeof jwtConfig === 'object' && jwtConfig.required !== false) ||\n      (jwtConfig === undefined && options.jwt?.global === true)\n\n    // Inject security requirement if JWT is required\n    if (requiresJWT) {\n      if (!routeOptions.schema) {\n        routeOptions.schema = {}\n      }\n      if (!routeOptions.schema.security) {\n        routeOptions.schema.security = [{ bearerAuth: [] }]\n      }\n    }\n  })\n}\n","import type { FastifyInstance } from 'fastify'\nimport fastifyJwt, { FastifyJWTOptions } from '@fastify/jwt'\nimport { formatError } from './response.ts'\nimport type { CreateFastifyOptions, JWTRouteConfig } from './types.ts'\n\nexport async function setupJWT(\n  fastify: FastifyInstance,\n  options: CreateFastifyOptions,\n  swaggerRoutePrefix: string | undefined\n): Promise<void> {\n  if (!options.jwt) {\n    return\n  }\n\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              return reply.status(403).send(\n                formatError(403, 'Forbidden', 'Authorization failed')\n              )\n            }\n          }\n        } catch (err) {\n          return reply.status(401).send(\n            formatError(401, 'Unauthorized', 'Invalid or missing JWT token')\n          )\n        }\n      }\n    })\n  }\n}\n","import { z } from 'zod'\nimport { FastifyServer } from './fastify.ts'\n\n/**\n * Base access token payload schema\n */\nexport const baseAccessTokenPayloadSchema = z.object({\n  identityId: z.string(),\n  type: z.literal('access'),\n  exp: z.number(),\n})\n\n/**\n * Base refresh token payload schema\n */\nexport const baseRefreshTokenPayloadSchema = z.object({\n  identityId: z.string(),\n  type: z.literal('refresh'),\n  exp: z.number(),\n})\n\n/**\n * Inferred types from base schemas\n */\nexport type BaseAccessTokenPayload = z.infer<typeof baseAccessTokenPayloadSchema>\nexport type BaseRefreshTokenPayload = z.infer<typeof baseRefreshTokenPayloadSchema>\n\n/**\n * Token pair interface\n */\nexport interface TokenPair {\n  accessToken: string\n  refreshToken: string\n}\n\n/**\n * FastifyJwtService configuration options\n */\nexport interface FastifyJwtServiceOptions {\n  accessTokenExpiry: string\n  refreshTokenExpiry: string\n  renewalThreshold: string\n  accessTokenSchema?: z.ZodSchema\n  refreshTokenSchema?: z.ZodSchema\n}\n\n/**\n * Generic JWT service for Fastify applications\n *\n * @template TAccess - Access token payload type extending BaseAccessTokenPayload\n * @template TRefresh - Refresh token payload type extending BaseRefreshTokenPayload\n *\n * @example\n * // Using base schemas\n * const jwtService = new FastifyJwtService(app, {\n *   accessTokenExpiry: '15m',\n *   refreshTokenExpiry: '7d',\n *   renewalThreshold: '1d',\n * })\n *\n * @example\n * // Using extended schemas\n * const customAccessSchema = baseAccessTokenPayloadSchema.extend({\n *   roles: z.array(z.string())\n * })\n * const jwtService = new FastifyJwtService(app, {\n *   accessTokenExpiry: '15m',\n *   refreshTokenExpiry: '7d',\n *   renewalThreshold: '1d',\n *   accessTokenSchema: customAccessSchema,\n * })\n */\nexport class FastifyJwtService<\n  TAccess extends BaseAccessTokenPayload = BaseAccessTokenPayload,\n  TRefresh extends BaseRefreshTokenPayload = BaseRefreshTokenPayload\n> {\n  private readonly accessTokenExpiry: string\n  private readonly refreshTokenExpiry: string\n  private readonly renewalThreshold: string\n  private readonly accessTokenSchema: z.ZodSchema<TAccess>\n  private readonly refreshTokenSchema: z.ZodSchema<TRefresh>\n\n  constructor(\n    private readonly app: FastifyServer,\n    options: FastifyJwtServiceOptions\n  ) {\n    this.accessTokenExpiry = options.accessTokenExpiry\n    this.refreshTokenExpiry = options.refreshTokenExpiry\n    this.renewalThreshold = options.renewalThreshold\n    this.accessTokenSchema = (options.accessTokenSchema ?? baseAccessTokenPayloadSchema) as z.ZodSchema<TAccess>\n    this.refreshTokenSchema = (options.refreshTokenSchema ?? baseRefreshTokenPayloadSchema) as z.ZodSchema<TRefresh>\n  }\n\n  /**\n   * Generate an access token for the given identity\n   */\n  generateAccessToken(identityId: string, extraPayload?: Partial<Omit<TAccess, 'identityId' | 'type' | 'exp'>>): string {\n    const payload = {\n      identityId,\n      type: 'access' as const,\n      ...extraPayload,\n    }\n\n    return this.app.jwt.sign(payload, {\n      expiresIn: this.accessTokenExpiry,\n    })\n  }\n\n  /**\n   * Generate a refresh token for the given identity\n   */\n  generateRefreshToken(identityId: string, extraPayload?: Partial<Omit<TRefresh, 'identityId' | 'type' | 'exp'>>): string {\n    const payload = {\n      identityId,\n      type: 'refresh' as const,\n      ...extraPayload,\n    }\n\n    return this.app.jwt.sign(payload, {\n      expiresIn: this.refreshTokenExpiry,\n    })\n  }\n\n  /**\n   * Generate both access and refresh tokens\n   */\n  generateTokenPair(identityId: string): TokenPair {\n    return {\n      accessToken: this.generateAccessToken(identityId),\n      refreshToken: this.generateRefreshToken(identityId),\n    }\n  }\n\n  /**\n   * Verify and decode an access token\n   */\n  verifyAccessToken(token: string): TAccess {\n    try {\n      const payload = this.app.jwt.verify(token) as unknown\n      const validated = this.accessTokenSchema.parse(payload)\n\n      if (validated.type !== 'access') {\n        throw new Error('Invalid token type')\n      }\n\n      return validated\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        throw new Error('Invalid token payload')\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Verify and decode a refresh token\n   */\n  verifyRefreshToken(token: string): TRefresh {\n    try {\n      const payload = this.app.jwt.verify(token) as unknown\n      const validated = this.refreshTokenSchema.parse(payload)\n\n      if (validated.type !== 'refresh') {\n        throw new Error('Invalid token type')\n      }\n\n      return validated\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        throw new Error('Invalid token payload')\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Renew a refresh token for the given identity\n   */\n  renewRefreshToken(identityId: string): string {\n    return this.generateRefreshToken(identityId)\n  }\n\n  /**\n   * Check if a refresh token should be renewed based on its expiry\n   */\n  shouldRenewRefreshToken(exp: number): boolean {\n    const now = Math.floor(Date.now() / 1000)\n    const threshold = this.parseTimespan(this.renewalThreshold)\n    return (exp - now) < threshold\n  }\n\n  /**\n   * Parse timespan string to seconds\n   */\n  private parseTimespan(timespan: string): number {\n    const match = timespan.match(/^(\\d+)([smhd])$/)\n    if (!match || !match[1] || !match[2]) {\n      throw new Error(`Invalid timespan format: ${timespan}`)\n    }\n\n    const value = parseInt(match[1]!, 10)\n    const unit = match[2]!\n\n    switch (unit) {\n      case 's':\n        return value\n      case 'm':\n        return value * 60\n      case 'h':\n        return value * 3600\n      case 'd':\n        return value * 86400\n      default:\n        throw new Error(`Unknown timespan unit: ${unit}`)\n    }\n  }\n}\n","import { FastifyPluginCallback } from 'fastify'\nimport { FastifyServer } from './fastify.ts'\nimport { ZodTypeProvider } from 'fastify-type-provider-zod'\n\nexport function createFastifyPlugin(cb: FastifyPluginCallback) {\n  return function createFastifyPluginWrapper(\n    fastify: FastifyServer,\n    options: Parameters<FastifyPluginCallback>[1],\n    done: Parameters<FastifyPluginCallback>[2],\n  ) {\n    const server = fastify.withTypeProvider<ZodTypeProvider>()\n    let doneCalled = false\n\n    const doneWrapper = (err?: Error) => {\n      done(err)\n      doneCalled = true\n    }\n\n    cb(server, options, doneWrapper)\n\n    if (!doneCalled) {\n      done()\n    }\n  }\n}\n","import { createFastifyPlugin } from '../plugin.ts'\nimport { FastifyServer } from '../fastify.ts'\n\nexport const healthPlugin = createFastifyPlugin((app: FastifyServer) => {\n  app.get('/v1/health', {\n    schema: {\n      tags: ['health'],\n    },\n    config: {\n      jwt: false,\n    },\n    handler: async () => {\n      return {\n        status: 200,\n        message: 'ok',\n      }\n    },\n  })\n})\n","export * from './lib/fastify.ts'\nexport * from './lib/response.ts'\nexport * from './lib/types.ts'\nexport * from './lib/jwt.service.ts'\nexport * from './lib/plugin.ts'\nexport * from './lib/plugins/healthPlugin.ts'\nexport * from 'fastify-type-provider-zod'\nexport type {\n  FastifyRequest,\n  FastifyReply,\n} from 'fastify'\n"],"mappings":"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","names":["z"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a_jackie_z/fastify",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "A collection of Fastify plugins and utilities for building robust web applications.",
   "license": "MIT",
   "author": "Sang Lu <connect.with.sang@gmail.com>",