@xenterprises/fastify-xconfig 1.0.1 → 1.1.0

package/README.md

@@ -1,29 +1,182 @@
-# __MY_PLUGIN__
+# xConfig - Fastify Configuration Plugin
 
-[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](http://standardjs.com/)  ![CI workflow](__MY_PLUGIN_URL__
-/workflows/CI%20workflow/badge.svg)
+**xConfig** is a Fastify configuration plugin designed for setting up middleware, services, and route handling.
 
-Supports Fastify versions `4.x`
+This plugin provides a comprehensive setup for configuring various services such as Prisma, SendGrid, Twilio, Cloudinary, CORS, rate limiting, authentication, and more within a Fastify instance. It centralizes configuration, allowing for easy customization and scaling.
 
-## Install
-```
-npm i __MY_PLUGIN__
-```
+## Key Features
+
+- Handles CORS, rate-limiting, multipart handling, and error handling out of the box.
+- Integrates with third-party services such as SendGrid, Twilio, Cloudinary, Stripe, and Bugsnag.
+- Provides authentication setup for both Admin and User, with Stack Auth integration.
+- Includes Prisma database connection and gracefully handles disconnecting on server shutdown.
+- Adds health check routes and resource usage monitoring, with environment validation.
+- Customizes route listing and applies various performance and security options.
 
 ## Usage
-Require `__MY_PLUGIN__` and register.
-```js
-const fastify = require('fastify')()
 
-fastify.register(require('__MY_PLUGIN__'), {
-  // put your options here
-})
+This plugin should be registered in your Fastify instance with custom options provided for each service. It ensures proper initialization of services like SendGrid, Twilio, and Prisma.
+
+### Example
+
+```typescript
+import Fastify from "fastify";
+import xConfig from "./path/to/xConfig";
 
-fastify.listen({ port: 3000 })
+const fastify = Fastify();
+fastify.register(xConfig, {
+  prisma: { active: true },
+  sendGrid: { apiKey: "your-sendgrid-api-key" },
+  twilio: {
+    accountSid: "your-account-sid",
+    authToken: "your-auth-token",
+    phoneNumber: "your-twilio-number",
+  },
+  cloudinary: {
+    cloudName: "your-cloud-name",
+    apiKey: "your-api-key",
+    apiSecret: "your-api-secret",
+  },
+  auth: {
+    excludedPaths: ["/public", "/portal/auth/register"],
+    admin: {
+      active: true,
+      stackProjectId: "your-admin-stack-project-id",
+      publishableKey: "your-admin-stack-publishable-key",
+      secretKey: "your-admin-stack-secret-key",
+    },
+    user: {
+      active: true,
+      stackProjectId: "your-user-stack-project-id",
+      publishableKey: "your-user-stack-publishable-key",
+      secretKey: "your-user-stack-secret-key",
+    },
+  },
+  cors: { origin: ["https://your-frontend.com"], credentials: true },
+});
+
+fastify.listen({ port: 3000 });
 ```
 
-## Acknowledgements
+## Parameters
+
+- **prisma**: Prisma Client configuration (optional).
+- **sendGrid**: SendGrid configuration for email services (optional).
+- **twilio**: Twilio configuration for SMS services (optional).
+- **cloudinary**: Cloudinary configuration for media upload services (optional).
+- **auth**: Authentication configuration for Admin and User with Stack Auth integration (optional).
+- **cors**: CORS configuration (optional).
+- **rateLimit**: Rate-limiting options (optional).
+- **multipart**: Multipart handling options for file uploads (optional).
+- **bugsnag**: Bugsnag error reporting configuration (optional).
+- **underPressure**: Under Pressure plugin options for monitoring and throttling under load (optional).
+
+## Authentication
+
+The plugin provides both Admin and User authentication with Stack Auth integration. It handles token verification, protected routes, and authentication endpoints.
+
+### User Authentication
+
+- `/portal/auth/login` - User login endpoint
+- `/portal/auth/me` - Get current user information
+- `/portal/auth/verify` - Verify a user token
+
+### Admin Authentication
+
+- `/admin/auth/login` - Admin login endpoint
+- `/admin/auth/me` - Get current admin information
+- `/admin/auth/verify` - Verify an admin token
+
+### Stack Auth Integration
+
+The plugin integrates with [Stack Auth](https://stack-auth.com) for secure authentication. You'll need to provide:
+
+- `stackProjectId` - Your Stack Auth project ID
+- `publishableKey` - Your Stack Auth publishable client key
+- `secretKey` - Your Stack Auth secret server key
+
+These can be provided via environment variables or in the plugin options.
+
+## Health Check
 
-## License
+The `/health` route provides a health check with details about uptime, memory usage, CPU load, database and Redis status, and environment variable validation.
 
-Licensed under [MIT](./LICENSE).<br/>
+## Services
+
+- **Prisma**: Initializes Prisma Client and decorates the Fastify instance for database queries.
+- **SendGrid**: Provides an email sending service through SendGrid, integrated with the Fastify instance.
+- **Twilio**: Provides SMS sending and phone number validation services.
+- **Cloudinary**: Handles file uploads to Cloudinary and deletion of media files.
+- **Authentication**: Stack Auth integration for secure user and admin authentication.
+
+## Hooks
+
+- **onRequest**: Validates tokens for protected routes.
+- **onClose**: Gracefully disconnects Prisma and other services on server shutdown.
+
+## Error Handling
+
+Enhanced error handling is enabled by default, showing detailed error messages during development. Bugsnag integration is optional for real-time error reporting.
+
+## Route Listing
+
+The plugin prints all routes after registration, color-coded by HTTP method, unless disabled.
+
+## Dependencies
+
+The following dependencies are used for various services and integrations:
+
+- Prisma Client, SendGrid, Twilio, Cloudinary, Fastify CORS, Fastify Rate Limit, Fastify Multipart, Fastify Under Pressure, and Fastify Bugsnag.
+
+## Environment Variables
+
+### Required for Authentication
+
+- `ADMIN_STACK_PROJECT_ID` - Stack Auth project ID for admin authentication
+- `ADMIN_STACK_PUBLISHABLE_CLIENT_KEY` - Stack Auth publishable key for admin authentication
+- `ADMIN_STACK_SECRET_SERVER_KEY` - Stack Auth secret key for admin authentication
+- `USER_STACK_PROJECT_ID` - Stack Auth project ID for user authentication
+- `USER_STACK_PUBLISHABLE_CLIENT_KEY` - Stack Auth publishable key for user authentication
+- `USER_STACK_SECRET_SERVER_KEY` - Stack Auth secret key for user authentication
+
+### Other Environment Variables
+
+- `DATABASE_URL` - Required for Prisma Client
+- `SENDGRID_API_KEY` - Required for SendGrid integration
+- `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_PHONE_NUMBER` - Required for Twilio integration
+- `CLOUDINARY_CLOUD_NAME`, `CLOUDINARY_API_KEY`, `CLOUDINARY_API_SECRET` - Required for Cloudinary integration
+
+## Example Configuration
+
+```javascript
+fastify.register(xConfig, {
+  prisma: { active: true },
+  sendGrid: { apiKey: "SG.your_api_key" },
+  twilio: {
+    accountSid: "ACxxxxxxxxxxxxxxxx",
+    authToken: "your_auth_token",
+    phoneNumber: "+1234567890",
+  },
+  cloudinary: {
+    cloudName: "your-cloud-name",
+    apiKey: "your-api-key",
+    apiSecret: "your-api-secret",
+  },
+  auth: {
+    excludedPaths: ["/public", "/portal/auth/login", "/portal/auth/register"],
+    admin: {
+      active: true,
+      stackProjectId: "your-admin-stack-project-id",
+      publishableKey: "your-admin-stack-publishable-key",
+      secretKey: "your-admin-stack-secret-key",
+    },
+    user: {
+      active: true,
+      stackProjectId: "your-user-stack-project-id",
+      publishableKey: "your-user-stack-publishable-key",
+      secretKey: "your-user-stack-secret-key",
+    },
+  },
+  cors: { origin: ["https://your-frontend.com"], credentials: true },
+});
+```

package/dist/integrations/cloudinary.d.ts

@@ -0,0 +1 @@
+export declare function setupCloudinary(fastify: any, cloudinaryOptions: any): Promise<void>;

package/dist/integrations/cloudinary.js

@@ -0,0 +1,25 @@
+import { v2 as Cloudinary } from "cloudinary";
+export async function setupCloudinary(fastify, cloudinaryOptions) {
+    if (cloudinaryOptions.active !== false) {
+        Cloudinary.config({
+            cloud_name: cloudinaryOptions.cloudName,
+            api_key: cloudinaryOptions.apiKey,
+            api_secret: cloudinaryOptions.apiSecret,
+        });
+        fastify.decorate("cloudinary", {
+            async upload(fileStream, options = {}) {
+                return new Promise((resolve, reject) => {
+                    const uploadStream = Cloudinary.uploader.upload_stream(options, (error, result) => {
+                        if (error)
+                            reject(error);
+                        else
+                            resolve(result);
+                    });
+                    fileStream.pipe(uploadStream);
+                });
+            },
+        });
+        console.info("   ✅ Cloudinary Enabled");
+    }
+}
+//# sourceMappingURL=cloudinary.js.map

package/dist/integrations/cloudinary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary.js","sourceRoot":"","sources":["../../src/integrations/cloudinary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAY,EAAE,iBAAsB;IACxE,IAAI,iBAAiB,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvC,UAAU,CAAC,MAAM,CAAC;YAChB,UAAU,EAAE,iBAAiB,CAAC,SAAS;YACvC,OAAO,EAAE,iBAAiB,CAAC,MAAM;YACjC,UAAU,EAAE,iBAAiB,CAAC,SAAS;SACxC,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;YAC7B,KAAK,CAAC,MAAM,CAAC,UAAe,EAAE,OAAO,GAAG,EAAE;gBACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBACrC,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,aAAa,CACpD,OAAO,EACP,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;wBAChB,IAAI,KAAK;4BAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;4BACpB,OAAO,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC,CACF,CAAC;oBACF,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/integrations/prisma.d.ts

@@ -0,0 +1 @@
+export declare function setupPrisma(fastify: any, prismaOptions: any): Promise<void>;

package/dist/integrations/prisma.js

@@ -0,0 +1,13 @@
+import { PrismaClient } from "@prisma/client";
+export async function setupPrisma(fastify, prismaOptions) {
+    if (prismaOptions.active !== false) {
+        const prisma = new PrismaClient(prismaOptions);
+        await prisma.$connect();
+        fastify.decorate("prisma", prisma);
+        fastify.addHook("onClose", async () => {
+            await fastify.prisma.$disconnect();
+        });
+        console.info("   ✅ Prisma Enabled");
+    }
+}
+//# sourceMappingURL=prisma.js.map

package/dist/integrations/prisma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.js","sourceRoot":"","sources":["../../src/integrations/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY,EAAE,aAAkB;IAChE,IAAI,aAAa,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YACpC,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/integrations/sendgrid.d.ts

@@ -0,0 +1 @@
+export declare function setupSendGrid(fastify: any, sendGridOptions: any): Promise<void>;

package/dist/integrations/sendgrid.js

@@ -0,0 +1,22 @@
+import Sendgrid from "@sendgrid/mail";
+export async function setupSendGrid(fastify, sendGridOptions) {
+    if (sendGridOptions.active !== false) {
+        if (!sendGridOptions.apiKey)
+            throw new Error("SendGrid API key must be provided.");
+        Sendgrid.setApiKey(sendGridOptions.apiKey);
+        fastify.decorate("sendgrid", {
+            async sendEmail(to, subject, templateId, dynamicTemplateData) {
+                const msg = {
+                    to,
+                    from: sendGridOptions.fromEmail,
+                    subject,
+                    templateId,
+                    dynamicTemplateData,
+                };
+                await Sendgrid.send(msg);
+            },
+        });
+        console.info("   ✅ SendGrid Enabled");
+    }
+}
+//# sourceMappingURL=sendgrid.js.map

package/dist/integrations/sendgrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgrid.js","sourceRoot":"","sources":["../../src/integrations/sendgrid.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAY,EAAE,eAAoB;IACpE,IAAI,eAAe,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,CAAC,MAAM;YACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE;YAC3B,KAAK,CAAC,SAAS,CACb,EAAU,EACV,OAAe,EACf,UAAkB,EAClB,mBAAwB;gBAExB,MAAM,GAAG,GAAG;oBACV,EAAE;oBACF,IAAI,EAAE,eAAe,CAAC,SAAS;oBAC/B,OAAO;oBACP,UAAU;oBACV,mBAAmB;iBACpB,CAAC;gBACF,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/integrations/stripe.d.ts

@@ -0,0 +1 @@
+export declare function setupStripe(fastify: any, stripeOptions: any): Promise<void>;

package/dist/integrations/stripe.js

@@ -0,0 +1,15 @@
+import Stripe from "stripe";
+export async function setupStripe(fastify, stripeOptions) {
+    if (stripeOptions.active !== false) {
+        const stripeClient = new Stripe(stripeOptions.apiKey, {
+            apiVersion: "2024-06-20",
+        });
+        fastify.decorate("stripe", {
+            async createPaymentIntent(amount, currency = "usd") {
+                return await stripeClient.paymentIntents.create({ amount, currency });
+            },
+        });
+        console.info("   ✅ Stripe Enabled");
+    }
+}
+//# sourceMappingURL=stripe.js.map

package/dist/integrations/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../src/integrations/stripe.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY,EAAE,aAAkB;IAChE,IAAI,aAAa,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE;YACpD,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACzB,KAAK,CAAC,mBAAmB,CAAC,MAAc,EAAE,QAAQ,GAAG,KAAK;gBACxD,OAAO,MAAM,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/integrations/twilio.d.ts

@@ -0,0 +1 @@
+export declare function setupTwilio(fastify: any, twilioOptions: any): Promise<void>;

package/dist/integrations/twilio.js

@@ -0,0 +1,17 @@
+import Twilio from "twilio";
+export async function setupTwilio(fastify, twilioOptions) {
+    if (twilioOptions.active !== false) {
+        const twilioClient = Twilio(twilioOptions.accountSid, twilioOptions.authToken);
+        fastify.decorate("twilio", {
+            async sendSMS(to, body) {
+                return await twilioClient.messages.create({
+                    body,
+                    to,
+                    from: twilioOptions.phoneNumber,
+                });
+            },
+        });
+        console.info("   ✅ Twilio Enabled");
+    }
+}
+//# sourceMappingURL=twilio.js.map

package/dist/integrations/twilio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.js","sourceRoot":"","sources":["../../src/integrations/twilio.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY,EAAE,aAAkB;IAChE,IAAI,aAAa,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,CACzB,aAAa,CAAC,UAAU,EACxB,aAAa,CAAC,SAAS,CACxB,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACzB,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,IAAY;gBACpC,OAAO,MAAM,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACxC,IAAI;oBACJ,EAAE;oBACF,IAAI,EAAE,aAAa,CAAC,WAAW;iBAChC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/middleware/bugsnag.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupBugsnag(fastify: FastifyInstance, options: any): Promise<void>;

package/dist/middleware/bugsnag.js

@@ -0,0 +1,9 @@
+export async function setupBugsnag(fastify, options) {
+    if (options.active !== false && options.apiKey) {
+        await fastify.register(import("fastify-bugsnag"), {
+            apiKey: options.apiKey,
+        });
+        console.info("   ✅ Bugsnag Enabled");
+    }
+}
+//# sourceMappingURL=bugsnag.js.map

package/dist/middleware/bugsnag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugsnag.js","sourceRoot":"","sources":["../../src/middleware/bugsnag.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAwB,EAAE,OAAY;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/middleware/cors.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupCors(fastify: FastifyInstance, options: any): Promise<void>;

package/dist/middleware/cors.js

@@ -0,0 +1,11 @@
+export async function setupCors(fastify, options) {
+    if (options.active !== false) {
+        await fastify.register(import("@fastify/cors"), {
+            origin: options.origin || ["https://getx.io", "http://localhost:3000"],
+            credentials: options.credentials !== undefined ? options.credentials : true,
+            methods: options.methods || ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+        });
+        console.info("   ✅ CORS Enabled");
+    }
+}
+//# sourceMappingURL=cors.js.map

package/dist/middleware/cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAwB,EAAE,OAAY;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE;YAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;YACtE,WAAW,EACT,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;YAChE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC;SACxE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/middleware/errorHandler.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupErrorHandler(fastify: FastifyInstance, fancyErrors: boolean): Promise<void>;

package/dist/middleware/errorHandler.js

@@ -0,0 +1,19 @@
+export async function setupErrorHandler(fastify, fancyErrors) {
+    if (fancyErrors !== false) {
+        fastify.setErrorHandler((error, request, reply) => {
+            const statusCode = error.statusCode || 500;
+            const response = {
+                status: statusCode,
+                message: error.message || "Internal Server Error",
+                stack: process.env.NODE_ENV === "development" ? error.stack : undefined,
+            };
+            // Optional Bugsnag error reporting
+            if (fastify.bugsnag)
+                fastify.bugsnag.notify(error);
+            fastify.log.error(response);
+            reply.status(statusCode).send(response);
+        });
+        console.info("   ✅ Fancy Errors Enabled");
+    }
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/middleware/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../src/middleware/errorHandler.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwB,EACxB,WAAoB;IAEpB,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;YAC3C,MAAM,QAAQ,GAAG;gBACf,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB;gBACjD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxE,CAAC;YAEF,mCAAmC;YACnC,IAAI,OAAO,CAAC,OAAO;gBAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5B,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/middleware/multipart.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupMultipart(fastify: FastifyInstance, options: any): Promise<void>;

package/dist/middleware/multipart.js

@@ -0,0 +1,7 @@
+export async function setupMultipart(fastify, options) {
+    if (options.active !== false) {
+        await fastify.register(import("@fastify/multipart"), options);
+        console.info("   ✅ Multipart Enabled");
+    }
+}
+//# sourceMappingURL=multipart.js.map

package/dist/middleware/multipart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../src/middleware/multipart.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAwB,EAAE,OAAY;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/middleware/rateLimit.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupRateLimit(fastify: FastifyInstance, options: any): Promise<void>;

package/dist/middleware/rateLimit.js

@@ -0,0 +1,7 @@
+export async function setupRateLimit(fastify, options) {
+    if (options.active !== false) {
+        await fastify.register(import("@fastify/rate-limit"), options);
+        console.info("   ✅ Rate Limiting Enabled");
+    }
+}
+//# sourceMappingURL=rateLimit.js.map

package/dist/middleware/rateLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.js","sourceRoot":"","sources":["../../src/middleware/rateLimit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAwB,EAAE,OAAY;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/middleware/underPressure.d.ts

@@ -0,0 +1,2 @@
+import { FastifyInstance } from "fastify";
+export declare function setupUnderPressure(fastify: FastifyInstance, options: any): Promise<void>;

package/dist/middleware/underPressure.js

@@ -0,0 +1,7 @@
+export async function setupUnderPressure(fastify, options) {
+    if (options.active !== false) {
+        await fastify.register(import("@fastify/under-pressure"), options);
+        console.info("   ✅ Under Pressure Enabled");
+    }
+}
+//# sourceMappingURL=underPressure.js.map

package/dist/middleware/underPressure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"underPressure.js","sourceRoot":"","sources":["../../src/middleware/underPressure.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAwB,EACxB,OAAY;IAEZ,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/utils/colorize.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance, RouteOptions } from "fastify";
+export declare function colorize(method: string, text: string): string;
+export declare function printRoutes(routes: RouteOptions[], colors?: boolean): void;
+export declare function captureRoutes(fastify: FastifyInstance): RouteOptions[];

package/dist/utils/colorize.js

@@ -0,0 +1,33 @@
+const COLORS = {
+    POST: 33,
+    GET: 32,
+    PUT: 34,
+    DELETE: 31,
+    PATCH: 90,
+    clear: 39,
+};
+// Function to colorize method and path names
+export function colorize(method, text) {
+    const colorCode = COLORS[method] || COLORS.clear;
+    return `\u001b[${colorCode}m${text}\u001b[${COLORS.clear}m`;
+}
+// Function to print the collected routes
+export function printRoutes(routes, colors = true) {
+    routes
+        .sort((a, b) => a.url.localeCompare(b.url))
+        .forEach(({ method, url }) => {
+        const methodsArray = Array.isArray(method) ? method : [method];
+        methodsArray
+            .filter((m) => m !== "HEAD")
+            .forEach((m) => console.info(`${colors ? colorize(m, m) : m}\t${colors ? colorize(m, url) : url}`));
+    });
+}
+// Helper function to capture all registered routes
+export function captureRoutes(fastify) {
+    const routes = [];
+    fastify.addHook("onRoute", (routeOptions) => {
+        routes.push(routeOptions);
+    });
+    return routes;
+}
+//# sourceMappingURL=colorize.js.map

package/dist/utils/colorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorize.js","sourceRoot":"","sources":["../../src/utils/colorize.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAA+B;IACzC,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAY;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAoB,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;IAC/D,OAAO,UAAU,SAAS,IAAI,IAAI,UAAU,MAAM,CAAC,KAAK,GAAG,CAAC;AAC9D,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,MAAM,GAAG,IAAI;IAC/D,MAAM;SACH,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAC1C,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;QAC3B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/D,YAAY;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;aAC3B,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACb,OAAO,CAAC,IAAI,CACV,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CACrE,CACF,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/formatBytes.d.ts

@@ -0,0 +1 @@
+export declare function formatBytes(bytes: number, decimals?: number): string;

package/dist/utils/formatBytes.js

@@ -0,0 +1,10 @@
+export function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0)
+        return "0 Bytes";
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}
+//# sourceMappingURL=formatBytes.js.map

package/dist/utils/formatBytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatBytes.js","sourceRoot":"","sources":["../../src/utils/formatBytes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAQ,GAAG,CAAC;IACrD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/utils/randomUUID.d.ts

@@ -0,0 +1 @@
+export declare const generateUUID: any;

package/dist/utils/randomUUID.js

@@ -0,0 +1,3 @@
+import { randomUUID } from "uncrypto";
+export const generateUUID = randomUUID;
+//# sourceMappingURL=randomUUID.js.map

package/dist/utils/randomUUID.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomUUID.js","sourceRoot":"","sources":["../../src/utils/randomUUID.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC"}

package/dist/utils/statAsync.d.ts

@@ -0,0 +1,2 @@
+import fs from "fs";
+export declare const statAsync: typeof fs.stat.__promisify__;

package/dist/utils/statAsync.js

@@ -0,0 +1,4 @@
+import fs from "fs";
+import util from "util";
+export const statAsync = util.promisify(fs.stat);
+//# sourceMappingURL=statAsync.js.map

package/dist/utils/statAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statAsync.js","sourceRoot":"","sources":["../../src/utils/statAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC"}

package/dist/xConfig.d.ts

@@ -0,0 +1,3 @@
+declare function xConfig(fastify: any, options: any): Promise<void>;
+declare const _default: typeof xConfig;
+export default _default;

package/dist/xConfig.js

@@ -0,0 +1,9 @@
+//src/xConfig.js
+import fp from "fastify-plugin";
+async function xConfig(fastify, options) {
+    fastify.decorate("xEcho", () => "Hello from X Enterprises!");
+}
+export default fp(xConfig, {
+    name: "xConfig",
+});
+//# sourceMappingURL=xConfig.js.map

package/dist/xConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xConfig.js","sourceRoot":"","sources":["../src/xConfig.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEhC,KAAK,UAAU,OAAO,CAAC,OAAO,EAAE,OAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,2BAA2B,CAAC,CAAC;AAC/D,CAAC;AAED,eAAe,EAAE,CAAC,OAAO,EAAE;IACzB,IAAI,EAAE,SAAS;CAChB,CAAC,CAAC"}