@xenterprises/fastify-xconfig 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,145 @@
+# xConfig - Fastify Configuration Plugin
+
+**xConfig** is a Fastify configuration plugin designed for setting up middleware, services, and route handling.
+
+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.
+
+## 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 JWT-based token handling.
+- 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
+
+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";
+
+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: {
+    admin: { secret: "admin-jwt-secret", expiresIn: "1h" },
+    user: { secret: "user-jwt-secret", expiresIn: "1h" },
+  },
+  cors: { origin: ["https://your-frontend.com"], credentials: true },
+});
+
+fastify.listen({ port: 3000 });
+```
+
+## 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 JWT tokens (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 JWT support. It sets secure cookies, manages token refresh, and validates tokens on protected routes.
+
+- `/admin/auth/login` for admin login.
+- `/portal/auth/login` for user login.
+- `/admin/auth/me` to check authentication status for admins.
+- `/portal/auth/me` to check authentication status for users.
+
+## Health Check
+
+The `/health` route provides a health check with details about uptime, memory usage, CPU load, database and Redis status, and environment variable validation.
+
+## 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**: JWT-based authentication for Admin and User with token-based sessions.
+
+## Hooks
+
+- **onRequest**: Validates JWT 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.
+
+## Notes
+
+- Environment variables such as `DATABASE_URL`, `ADMIN_JWT_SECRET`, and `USER_JWT_SECRET` are expected to be set.
+- Services like SendGrid, Twilio, and Cloudinary require API keys to be passed via the options.
+- This plugin is highly customizable, with options to enable/disable each feature.
+
+## 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: {
+    admin: {
+      secret: "admin-secret",
+      expiresIn: "1h",
+      cookieOptions: {
+        name: "adminCookie",
+        refreshTokenName: "adminRefreshToken",
+      },
+    },
+    user: {
+      secret: "user-secret",
+      expiresIn: "1h",
+      cookieOptions: {
+        name: "userCookie",
+        refreshTokenName: "userRefreshToken",
+      },
+    },
+  },
+  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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xenterprises/fastify-xconfig",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Fastify configuration plugin for setting up middleware, services, and route handling.",
   "main": "src/xConfig.js",
   "scripts": {
@@ -20,6 +20,29 @@
     "typescript": "^5.6.3"
   },
   "dependencies": {
-    "@fastify/autoload": "^6.0.2"
+    "@fastify/autoload": "^6.0.2",
+    "@fastify/cookie": "^9.4.0",
+    "@fastify/cors": "^9.0.1",
+    "@fastify/jwt": "^8.0.1",
+    "@fastify/multipart": "^8.3.0",
+    "@fastify/rate-limit": "^9.1.0",
+    "@fastify/sensible": "^5.6.0",
+    "@fastify/under-pressure": "^9.0.1",
+    "@prisma/client": "^5.20.0",
+    "@sendgrid/client": "^8.1.3",
+    "@sendgrid/mail": "^8.1.3",
+    "bcrypt": "^5.1.1",
+    "check-disk-space": "^3.4.0",
+    "fastify": "^4.28.1",
+    "fastify-bugsnag": "^4.1.4",
+    "fastify-cli": "^6.2.1",
+    "fastify-cloudinary": "^2.0.0",
+    "fastify-list-routes": "^1.0.0",
+    "fastify-multipart": "^5.4.0",
+    "fastify-plugin": "^4.0.0",
+    "fastify-rate-limit": "^5.9.0",
+    "stripe": "^16.12.0",
+    "twilio": "^5.3.2",
+    "uncrypto": "^0.1.3"
   }
 }

package/server/app.js

@@ -6,7 +6,84 @@ const fastify = Fastify();
 
 
 export default async function (fastify, opts) {
-  fastify.register(xConfig);  // Register the default export, which should be a function
+  fastify.register(xConfig, {
+    professional: false,
+    fancyErrors: true,
+    prisma: {
+      active: false,
+    },
+    bugsnag: {
+      apiKey: process.env.BUGSNAG_API_KEY
+    },
+    rateLimit: {
+      max: process.env.RATE_LIMIT_MAX || 100,
+      timeWindow: process.env.RATE_LIMIT_TIME_WINDOW || '1 minute'
+    },
+    stripe: {
+      active: false,
+      apiKey: process.env.STRIPE_API_KEY
+    },
+    sendGrid: {
+      active: true,
+      apiKey: process.env.SENDGRID_API_KEY,
+      apiKeyEmailValidation: process.env.SENDGRID_API_EMAIL_VALIDATION_KEY,
+      fromEmail: process.env.SENDGRID_FROM_EMAIL || 'ops@getx.io',
+    },
+    twilio: {
+      active: true,
+      accountSid: process.env.TWILIO_ACCOUNT_SID,
+      authToken: process.env.TWILIO_AUTH_TOKEN,
+      phoneNumber: process.env.TWILIO_PHONE_NUMBER
+    },
+    cloudinary: {
+      active: false,
+      cloudName: process.env.CLOUDINARY_CLOUD_NAME,
+      apiKey: process.env.CLOUDINARY_API_KEY,
+      apiSecret: process.env.CLOUDINARY_API_SECRET,
+      basePath: process.env.CLOUDINARY_BASE_PATH || 'basepath'
+    },
+    cors: {
+      active: true,
+      origin: process.env.CORS_ORIGIN || ['http://localhost:3000', 'https://app.bandmate.io'],
+      credentials: true
+    },
+    auth: {
+      excludedPaths: ['/public', '/portal/auth/register'],
+      admin: {
+        active: true,
+        secret: process.env.ADMIN_JWT_SECRET,
+        expiresIn: '1h',
+        cookieOptions: {
+          name: 'adminToken',
+          httpOnly: true,
+          secure: true, // Set to false if not using HTTPS
+          sameSite: 'strict', // Can be 'lax', 'strict', or 'none'
+        }
+      },
+      user: {
+        active: true,
+        secret: process.env.USER_JWT_SECRET,
+        expiresIn: '1h',
+        cookieOptions: {
+          name: 'userToken',
+          httpOnly: true,
+          secure: true,
+          sameSite: 'strict',
+        },
+        me: {
+          isOnboarded: true
+        },
+        registerEmail: {
+          subject: 'Welcome to Bandmate!',
+          templateId: ''
+        }
+      },
+    },
+    geocode: {
+      active: true,
+      apiKey: process.env.GEOCODIO_API_KEY
+    }
+  });  // Register the default export, which should be a function
   fastify.get('/', async (request, reply) => {
     console.log(fastify.xEcho())
     return { status: fastify.xEcho() }