@xenterprises/fastify-xconfig 0.0.10 → 1.0.1

package/src/middleware/bugsnag.js

@@ -1,10 +0,0 @@
-export async function setupBugsnag(fastify, options) {
-  if (options.active !== false) {
-    if (!options.apiKey)
-      throw new Error("Bugsnag API key must be provided.");
-    fastify.register(import("fastify-bugsnag"), {
-      apiKey: options.apiKey,
-    });
-    console.info("   ✅ BugSnag Enabled");
-  }
-}

package/src/middleware/cors.js

@@ -1,10 +0,0 @@
-export async function setupCors(fastify, options) {
-  if (options.active !== false) {
-    await fastify.register(await 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");
-  }
-}

package/src/middleware/fancyErrors.js

@@ -1,26 +0,0 @@
-export async function setupFancyErrors(fastify, options) {
-
-  /*
-    ===== EXTEND ERRORS =====
-  */
-  if (options.fancyErrors !== false) {
-    fastify.setErrorHandler((error, request, reply) => {
-      const statusCode = error.statusCode || 500;
-      const response = {
-        status: statusCode,
-        message: error.message || "Internal Server Error",
-        // Only show stack in development mode
-        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");
-  }
-}

package/src/middleware/multipart.js

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

package/src/middleware/rateLimit.js

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

package/src/middleware/underPressure.js

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

package/src/utils/colorize.js

@@ -1,37 +0,0 @@
-// src/utils/colorize.js
-const colors = {
-  POST: 33,
-  GET: 32,
-  PUT: 34,
-  DELETE: 31,
-  PATCH: 90,
-  clear: 39,
-};
-
-
-// Function to colorize method and path names
-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
-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}`
-          )
-        );
-    });
-}
-
-export {
-  colors,
-  colorize,
-  printRoutes,
-};

package/src/utils/cookie.js

@@ -1,5 +0,0 @@
-export async function setupCookie(fastify, options) {
-  fastify.register(import("@fastify/cookie"));
-
-  console.info("   ✅ @fastify/cookie Enabled");
-}

package/src/utils/formatBytes.js

@@ -1,16 +0,0 @@
-import fp from "fastify-plugin";
-
-async function formatBytesPlugin(fastify, options) {
-  fastify.decorate("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];
-  });
-}
-
-export default fp(formatBytesPlugin);

package/src/utils/health.js

@@ -1,126 +0,0 @@
-// Import necessary modules
-import os from "os";
-import process from "process";
-import fs from "fs";
-import util from "util";
-
-
-// Promisify fs functions
-const statAsync = util.promisify(fs.stat);
-
-// Record the server start time
-const serverStartTime = Date.now();
-
-// Helper function to format bytes into human-readable format
-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));
-  const formattedNumber = parseFloat((bytes / Math.pow(k, i)).toFixed(dm));
-  return `${formattedNumber} ${sizes[i]}`;
-}
-
-export async function setupHealth(fastify, options) {
-  fastify.get("/health", async (request, reply) => {
-    const status = {
-      status: "healthy",
-      timestamp: new Date().toISOString(),
-      uptime: process.uptime(), // Uptime in seconds
-      version: "1.0.0", // Fetch dynamically if possible
-      environment: process.env.NODE_ENV || "development",
-      dependencies: {},
-      resources: {},
-      details: {},
-    };
-
-    try {
-      // Database connectivity check
-      if (fastify.prisma) {
-        await fastify.prisma.$queryRaw`SELECT 1`;
-        status.dependencies.database = "up";
-      } else {
-        status.dependencies.database = "not configured";
-      }
-    } catch (error) {
-      status.dependencies.database = "down";
-      status.status = "degraded";
-      status.details.databaseError = error.message;
-    }
-
-    try {
-      // Redis connectivity check
-      if (fastify.redis) {
-        await fastify.redis.ping();
-        status.dependencies.redis = "up";
-      } else {
-        status.dependencies.redis = "not configured";
-      }
-    } catch (error) {
-      status.dependencies.redis = "down";
-      status.status = "degraded";
-      status.details.redisError = error.message;
-    }
-
-    // Resource usage
-    const memoryUsage = process.memoryUsage();
-    const loadAverage = os.loadavg();
-
-    status.resources.memory = {
-      rss: formatBytes(memoryUsage.rss),
-      heapTotal: formatBytes(memoryUsage.heapTotal),
-      heapUsed: formatBytes(memoryUsage.heapUsed),
-      external: formatBytes(memoryUsage.external),
-      arrayBuffers: formatBytes(memoryUsage.arrayBuffers),
-    };
-
-    status.resources.cpu = {
-      loadAverage, // 1, 5, and 15 minute load averages
-      cpus: os.cpus().length,
-    };
-
-    // Disk space availability
-    try {
-      // Implement disk space check using 'check-disk-space' package
-      // Install it via 'npm install check-disk-space'
-      const checkDiskSpace = (await import("check-disk-space")).default;
-      const diskSpace = await checkDiskSpace("/"); // Replace '/' with your drive or mount point
-      status.resources.disk = {
-        free: formatBytes(diskSpace.free),
-        size: formatBytes(diskSpace.size),
-      };
-    } catch (error) {
-      status.resources.disk = "unknown";
-      status.details.diskError = error.message;
-    }
-
-    // Application-specific checks
-    // Example: Check if a scheduled job is running
-    if (typeof isJobRunning === "function" && !isJobRunning()) {
-      status.status = "degraded";
-      status.details.jobStatus = "Scheduled job is not running";
-    }
-
-    // Configuration validation
-    const requiredEnvVars = [
-      "DATABASE_URL",
-      "ADMIN_JWT_SECRET",
-      "USER_JWT_SECRET",
-    ];
-    const missingEnvVars = requiredEnvVars.filter(
-      (varName) => !process.env[varName]
-    );
-    if (missingEnvVars.length > 0) {
-      status.status = "degraded";
-      status.details.missingEnvVars = missingEnvVars;
-    }
-
-    // Determine overall health
-    if (status.status === "healthy") {
-      reply.send(status);
-    } else {
-      reply.status(500).send(status);
-    }
-  });
-}

package/src/utils/xEcho.js

@@ -1,12 +0,0 @@
-// src/utils/xEcho.js
-import fp from "fastify-plugin";
-
-async function xEcho(fastify, options) {
-  fastify.decorate("xEcho", function () {
-    return "Hello from X Enterprises!"
-  });
-}
-
-export default fp(xEcho, {
-  name: "xEcho",
-});

package/src/utils/xSlugify.js

@@ -1,20 +0,0 @@
-// src/utils/xSlugify.js
-import fp from "fastify-plugin";
-
-async function xSlugify(fastify, options) {
-  fastify.decorate('slugify', (string) => {
-    return string
-      .toString()
-      .toLowerCase()                   // Convert to lowercase
-      .trim()                          // Trim leading and trailing spaces
-      .replace(/\s+/g, '-')            // Replace spaces with -
-      .replace(/[^\w\-]+/g, '')        // Remove all non-word characters (allow only letters, numbers, and dashes)
-      .replace(/\-\-+/g, '-')          // Replace multiple dashes with a single dash
-      .replace(/^-+/, '')              // Trim leading dashes
-      .replace(/-+$/, '');             // Trim trailing dashes
-  });
-}
-
-export default fp(xSlugify, {
-  name: "xSlugify",
-});

package/src/utils/xUUID.js

@@ -1,14 +0,0 @@
-import fp from "fastify-plugin";
-import { randomUUID } from "uncrypto";
-
-async function xUUID(fastify, options) {
-  fastify.decorate("generateUUID", randomUUID);
-
-  fastify.decorate('randomUUID', () => {
-    return randomUUID(); // Generate a UUID using uncrypto's randomUUID
-  });
-}
-
-export default fp(xUUID, {
-  name: "xUUID",
-});

package/src/xConfig.js

@@ -1,117 +0,0 @@
-// src/xConfig.js
-import fp from "fastify-plugin";
-const isProduction = process.env.NODE_ENV === 'production';
-/*
-* Auth
-*/
-import { setupAdminAuth } from "./auth/admin.js";
-import { setupAuth } from "./auth/portal.js";
-
-
-/*
-* Integrations
-*/
-import { setupPrisma } from "./integrations/prisma.js";
-import { setupSendgrid } from "./integrations/sendgrid.js";
-import { setupTwilio } from "./integrations/twilio.js";
-import { setupCloudinary } from "./integrations/cloudinary.js";
-import { setupGeocode } from "./integrations/geocode.js";
-
-/*
-* Lifecycle
-*/
-import { xFastifyAfter } from "./lifecycle/xFastifyAfter.js";
-
-
-/*
-* Middleware
-*/
-import { setupCors } from './middleware/cors.js';
-import { setupUnderPressure } from './middleware/underPressure.js';
-import { setupRateLimit } from './middleware/rateLimit.js';
-import { setupMultipart } from './middleware/multipart.js';
-import { setupBugsnag } from './middleware/bugsnag.js';
-import { setupFancyErrors } from './middleware/fancyErrors.js'
-
-/*
-* Utils
-*/
-import xEcho from "./utils/xEcho.js";
-import { setupHealth } from "./utils/health.js";
-import xSlugify from "./utils/xSlugify.js";
-import xUUID from "./utils/xUUID.js";
-import { setupCookie } from "./utils/cookie.js";
-
-async function xConfig(fastify, options) {
-  const {
-    professional = false,
-    fancyErrors = true,
-    prisma: prismaOptions = {},
-    bugsnag: bugsnagOptions = {},
-    stripe: stripeOptions = {},
-    sendGrid: sendGridOptions = {},
-    twilio: twilioOptions = {},
-    cloudinary: cloudinaryOptions = {},
-    auth: authOptions = {},
-    cors: corsOptions = {},
-    underPressure: underPressureOptions = {},
-    multipart: multipartOptions = {},
-    rateLimit: rateLimitOptions = {},
-    geocode: geocodeOptions = {},
-  } = options;
-
-  // add starting console with emoji
-  console.info("\n 🌮 Starting xConfig...\n");
-
-  /*
-    ===== LIST ROUTES =====
-    Moved the onRoute hook to the top to capture all routes.
-  */
-  const routes = [];
-  fastify.addHook("onRoute", (r) => routes.push(r));
-
-  /*
-  * Integrations
-  */
-  await setupPrisma(fastify, prismaOptions);
-  await setupSendgrid(fastify, sendGridOptions);
-  await setupTwilio(fastify, twilioOptions);
-  await setupCloudinary(fastify, cloudinaryOptions);
-  await setupGeocode(fastify, geocodeOptions);
-
-  /*
-  * Middleware
-  */
-  await setupCors(fastify, corsOptions);
-  await setupUnderPressure(fastify, underPressureOptions);
-  await setupRateLimit(fastify, rateLimitOptions);
-  await setupMultipart(fastify, multipartOptions);
-  await setupBugsnag(fastify, bugsnagOptions);
-  await setupFancyErrors(fastify, fancyErrors);
-  fastify.register(import('@fastify/sensible'))
-
-  /*
-  * Utils
-  */
-
-  fastify.register(xEcho);
-  fastify.register(xSlugify);
-  fastify.register(xUUID);
-  await setupHealth(fastify);
-  await setupCookie(fastify, authOptions);
-
-  /*
-  * Auth
-  */
-  await setupAuth(fastify, authOptions);
-  await setupAdminAuth(fastify, authOptions);
-
-
-  //.after() method to ensure this runs after all plugins are registered.
-  await xFastifyAfter(fastify, { professional, routes });
-
-}
-
-export default fp(xConfig, {
-  name: "xConfig",
-});

package/test/index.js

@@ -1,17 +0,0 @@
-// test.js
-const fastify = require('fastify')();
-const myPlugin = require('../src/xConfig');
-
-fastify.register(myPlugin);
-
-fastify.get('/', async (request, reply) => {
-  return { message: fastify.myPluginMethod() };
-});
-
-fastify.listen(3000, (err, address) => {
-  if (err) {
-    console.error(err);
-    process.exit(1);
-  }
-  console.log(`Server running at ${address}`);
-});

package/ts-reference/integrations/cloudinary.ts

@@ -1,26 +0,0 @@
-import { v2 as Cloudinary } from "cloudinary";
-
-export async function setupCloudinary(fastify: any, cloudinaryOptions: any) {
-  if (cloudinaryOptions.active !== false) {
-    Cloudinary.config({
-      cloud_name: cloudinaryOptions.cloudName,
-      api_key: cloudinaryOptions.apiKey,
-      api_secret: cloudinaryOptions.apiSecret,
-    });
-    fastify.decorate("cloudinary", {
-      async upload(fileStream: any, 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");
-  }
-}

package/ts-reference/integrations/prisma.ts

@@ -1,13 +0,0 @@
-import { PrismaClient } from "@prisma/client";
-
-export async function setupPrisma(fastify: any, prismaOptions: any) {
-  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");
-  }
-}

package/ts-reference/integrations/sendgrid.ts

@@ -1,27 +0,0 @@
-import Sendgrid from "@sendgrid/mail";
-
-export async function setupSendGrid(fastify: any, sendGridOptions: any) {
-  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: string,
-        subject: string,
-        templateId: string,
-        dynamicTemplateData: any
-      ) {
-        const msg = {
-          to,
-          from: sendGridOptions.fromEmail,
-          subject,
-          templateId,
-          dynamicTemplateData,
-        };
-        await Sendgrid.send(msg);
-      },
-    });
-    console.info("   ✅ SendGrid Enabled");
-  }
-}

package/ts-reference/integrations/stripe.ts

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

package/ts-reference/integrations/twilio.ts

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

package/ts-reference/middleware/bugsnag.ts

@@ -1,10 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupBugsnag(fastify: FastifyInstance, options: any) {
-  if (options.active !== false && options.apiKey) {
-    await fastify.register(import("fastify-bugsnag"), {
-      apiKey: options.apiKey,
-    });
-    console.info("   ✅ Bugsnag Enabled");
-  }
-}

package/ts-reference/middleware/cors.ts

@@ -1,13 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupCors(fastify: FastifyInstance, options: any) {
-  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");
-  }
-}

package/ts-reference/middleware/errorHandler.ts

@@ -1,24 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupErrorHandler(
-  fastify: FastifyInstance,
-  fancyErrors: boolean
-) {
-  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");
-  }
-}

package/ts-reference/middleware/multipart.ts

@@ -1,8 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupMultipart(fastify: FastifyInstance, options: any) {
-  if (options.active !== false) {
-    await fastify.register(import("@fastify/multipart"), options);
-    console.info("   ✅ Multipart Enabled");
-  }
-}

package/ts-reference/middleware/rateLimit.ts

@@ -1,8 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupRateLimit(fastify: FastifyInstance, options: any) {
-  if (options.active !== false) {
-    await fastify.register(import("@fastify/rate-limit"), options);
-    console.info("   ✅ Rate Limiting Enabled");
-  }
-}

package/ts-reference/middleware/underPressure.ts

@@ -1,11 +0,0 @@
-import { FastifyInstance } from "fastify";
-
-export async function setupUnderPressure(
-  fastify: FastifyInstance,
-  options: any
-) {
-  if (options.active !== false) {
-    await fastify.register(import("@fastify/under-pressure"), options);
-    console.info("   ✅ Under Pressure Enabled");
-  }
-}