mikroserve 0.0.2 → 0.0.4

package/lib/{chunk-GGGGATKH.mjs → chunk-6UXWR6LD.mjs}

@@ -4,97 +4,121 @@ import {
 import {
   Router
 } from "./chunk-KJT4SET2.mjs";
+import {
+  configDefaults
+} from "./chunk-RP67R3W4.mjs";
 
 // src/MikroServe.ts
 import { readFileSync } from "node:fs";
 import http from "node:http";
 import https from "node:https";
+import { MikroConf, parsers } from "mikroconf";
 var MikroServe = class {
-  config;
   rateLimiter;
   router;
-  useHttps;
-  sslCert;
-  sslKey;
-  sslCa;
-  debug;
+  config;
   /**
    * @description Creates a new MikroServe instance.
-   * @param config - Server configuration options
    */
-  constructor(config) {
+  constructor(options) {
+    const defaults = configDefaults();
+    const config = new MikroConf({
+      configFilePath: "mikroserve.config.json",
+      args: process.argv,
+      options: [
+        { flag: "--port", path: "port", defaultValue: defaults.port },
+        { flag: "--host", path: "host", defaultValue: defaults.host },
+        { flag: "--https", path: "useHttps", defaultValue: defaults.useHttps, isFlag: true },
+        { flag: "--cert", path: "sslCert", defaultValue: defaults.sslCert },
+        { flag: "--key", path: "sslKey", defaultValue: defaults.sslKey },
+        { flag: "--ca", path: "sslCa", defaultValue: defaults.sslCa },
+        {
+          flag: "--ratelimit",
+          path: "rateLimit.enabled",
+          defaultValue: defaults.rateLimit.enabled,
+          isFlag: true
+        },
+        {
+          flag: "--rps",
+          path: "rateLimit.requestsPerMinute",
+          defaultValue: defaults.rateLimit.requestsPerMinute
+        },
+        {
+          flag: "--allowed",
+          path: "allowedDomains",
+          defaultValue: defaults.allowedDomains,
+          parser: parsers.array
+        },
+        { flag: "--debug", path: "debug", defaultValue: defaults.debug, isFlag: true }
+      ],
+      config: options
+    }).get();
+    if (config.debug) console.log("Using configuration:", config);
     this.config = config;
-    const { useHttps, sslCa, sslCert, sslKey, debug } = config;
-    const requestsPerMinute = config.rateLimit?.requestsPerMinute || 50;
-    this.rateLimiter = new RateLimiter(requestsPerMinute, 60);
     this.router = new Router();
-    this.useHttps = useHttps || false;
-    this.sslCert = sslCert;
-    this.sslKey = sslKey;
-    this.sslCa = sslCa;
-    this.debug = debug || false;
-    if (config.rateLimit?.enabled !== false) this.use(this.rateLimitMiddleware.bind(this));
+    const requestsPerMinute = config.rateLimit.requestsPerMinute || defaults.rateLimit.requestsPerMinute;
+    this.rateLimiter = new RateLimiter(requestsPerMinute, 60);
+    if (config.rateLimit.enabled === true) this.use(this.rateLimitMiddleware.bind(this));
   }
   /**
-   * Register a global middleware
+   * @description Register a global middleware.
    */
   use(middleware) {
     this.router.use(middleware);
     return this;
   }
   /**
-   * Register a GET route
+   * @description Register a GET route.
    */
   get(path, ...handlers) {
     this.router.get(path, ...handlers);
     return this;
   }
   /**
-   * Register a POST route
+   * @description Register a POST route.
    */
   post(path, ...handlers) {
     this.router.post(path, ...handlers);
     return this;
   }
   /**
-   * Register a PUT route
+   * @description Register a PUT route.
    */
   put(path, ...handlers) {
     this.router.put(path, ...handlers);
     return this;
   }
   /**
-   * Register a DELETE route
+   * @description Register a DELETE route.
    */
   delete(path, ...handlers) {
     this.router.delete(path, ...handlers);
     return this;
   }
   /**
-   * Register a PATCH route
+   * @description Register a PATCH route.
    */
   patch(path, ...handlers) {
     this.router.patch(path, ...handlers);
     return this;
   }
   /**
-   * Register an OPTIONS route
+   * @description Register an OPTIONS route.
    */
   options(path, ...handlers) {
     this.router.options(path, ...handlers);
     return this;
   }
   /**
-   * Creates an HTTP/HTTPS server, sets up graceful shutdown, and starts listening.
-   * @returns Running HTTP/HTTPS server
+   * @description Creates an HTTP/HTTPS server, sets up graceful shutdown, and starts listening.
    */
   start() {
     const server = this.createServer();
-    const { port = 3e3, host = "localhost" } = this.config;
+    const { port, host } = this.config;
     this.setupGracefulShutdown(server);
     server.listen(port, host, () => {
       const address = server.address();
-      const protocol = this.useHttps ? "https" : "http";
+      const protocol = this.config.useHttps ? "https" : "http";
       console.log(
         `MikroServe running at ${protocol}://${address.address !== "::" ? address.address : "localhost"}:${address.port}`
       );
@@ -102,19 +126,18 @@ var MikroServe = class {
     return server;
   }
   /**
-   * Creates and configures a server instance without starting it.
-   * @returns Configured HTTP or HTTPS server instance
+   * @description Creates and configures a server instance without starting it.
    */
   createServer() {
     const boundRequestHandler = this.requestHandler.bind(this);
-    if (this.useHttps) {
-      if (!this.sslCert || !this.sslKey)
+    if (this.config.useHttps) {
+      if (!this.config.sslCert || !this.config.sslKey)
         throw new Error("SSL certificate and key paths are required when useHttps is true");
       try {
         const httpsOptions = {
-          key: readFileSync(this.sslKey),
-          cert: readFileSync(this.sslCert),
-          ...this.sslCa ? { ca: readFileSync(this.sslCa) } : {}
+          key: readFileSync(this.config.sslKey),
+          cert: readFileSync(this.config.sslCert),
+          ...this.config.sslCa ? { ca: readFileSync(this.config.sslCa) } : {}
         };
         return https.createServer(httpsOptions, boundRequestHandler);
       } catch (error) {
@@ -126,7 +149,7 @@ var MikroServe = class {
     return http.createServer(boundRequestHandler);
   }
   /**
-   * Rate limiting middleware
+   * @description Rate limiting middleware.
    */
   async rateLimitMiddleware(context, next) {
     const ip = context.req.socket.remoteAddress || "unknown";
@@ -149,16 +172,17 @@ var MikroServe = class {
     return next();
   }
   /**
-   * Request handler for HTTP and HTTPS servers.
+   * @description Request handler for HTTP and HTTPS servers.
    */
   async requestHandler(req, res) {
     const start = Date.now();
     const method = req.method || "UNKNOWN";
     const url = req.url || "/unknown";
+    const isDebug = this.config.debug;
     try {
       this.setCorsHeaders(res, req);
-      this.setSecurityHeaders(res, this.useHttps);
-      if (this.debug) console.log(`${method} ${url}`);
+      this.setSecurityHeaders(res, this.config.useHttps);
+      if (isDebug) console.log(`${method} ${url}`);
       if (req.method === "OPTIONS") {
         res.statusCode = 204;
         res.end();
@@ -167,9 +191,7 @@ var MikroServe = class {
       try {
         req.body = await this.parseBody(req);
       } catch (error) {
-        if (this.debug) {
-          console.error("Body parsing error:", error.message);
-        }
+        if (isDebug) console.error("Body parsing error:", error.message);
         return this.respond(res, {
           statusCode: 400,
           body: {
@@ -193,33 +215,22 @@ var MikroServe = class {
         statusCode: 500,
         body: {
           error: "Internal Server Error",
-          message: this.debug ? error.message : "An unexpected error occurred"
+          message: isDebug ? error.message : "An unexpected error occurred"
         }
       });
     } finally {
-      if (this.debug) {
-        this.logDuration(start, method, url);
-      }
+      if (isDebug) this.logDuration(start, method, url);
     }
   }
   /**
-   * Writes out a clean log to represent the duration of the request.
+   * @description Writes out a clean log to represent the duration of the request.
    */
   logDuration(start, method, url) {
     const duration = Date.now() - start;
     console.log(`${method} ${url} completed in ${duration}ms`);
   }
   /**
-   * Parses the request body based on content type.
-   * @param req - HTTP request object
-   * @returns Promise resolving to the parsed body
-   * @throws Will throw if body cannot be parsed
-   */
-  /**
-   * Parses the request body based on content type.
-   * @param req - HTTP request object
-   * @returns Promise resolving to the parsed body
-   * @throws Will throw if body cannot be parsed
+   * @description Parses the request body based on content type.
    */
   async parseBody(req) {
     return new Promise((resolve, reject) => {
@@ -227,17 +238,17 @@ var MikroServe = class {
       let bodySize = 0;
       const MAX_BODY_SIZE = 1024 * 1024;
       let rejected = false;
+      const isDebug = this.config.debug;
       const contentType = req.headers["content-type"] || "";
-      if (this.debug) {
+      if (isDebug) {
         console.log("Content-Type:", contentType);
       }
       req.on("data", (chunk) => {
         bodySize += chunk.length;
-        if (this.debug)
-          console.log(`Received chunk: ${chunk.length} bytes, total size: ${bodySize}`);
+        if (isDebug) console.log(`Received chunk: ${chunk.length} bytes, total size: ${bodySize}`);
         if (bodySize > MAX_BODY_SIZE && !rejected) {
           rejected = true;
-          if (this.debug) console.log(`Body size exceeded limit: ${bodySize} > ${MAX_BODY_SIZE}`);
+          if (isDebug) console.log(`Body size exceeded limit: ${bodySize} > ${MAX_BODY_SIZE}`);
           reject(new Error("Request body too large"));
           return;
         }
@@ -245,7 +256,7 @@ var MikroServe = class {
       });
       req.on("end", () => {
         if (rejected) return;
-        if (this.debug) console.log(`Request body complete: ${bodySize} bytes`);
+        if (isDebug) console.log(`Request body complete: ${bodySize} bytes`);
         try {
           if (bodyChunks.length > 0) {
             const bodyString = Buffer.concat(bodyChunks).toString("utf8");
@@ -277,17 +288,14 @@ var MikroServe = class {
     });
   }
   /**
-   * CORS middleware
+   * @description CORS middleware.
    */
-  // Update the setCorsHeaders method in MikroServe class to handle allowed domains
   setCorsHeaders(res, req) {
     const origin = req.headers.origin;
     const { allowedDomains = ["*"] } = this.config;
-    if (!origin || allowedDomains.length === 0) {
-      res.setHeader("Access-Control-Allow-Origin", "*");
-    } else if (allowedDomains.includes("*")) {
-      res.setHeader("Access-Control-Allow-Origin", "*");
-    } else if (allowedDomains.includes(origin)) {
+    if (!origin || allowedDomains.length === 0) res.setHeader("Access-Control-Allow-Origin", "*");
+    else if (allowedDomains.includes("*")) res.setHeader("Access-Control-Allow-Origin", "*");
+    else if (allowedDomains.includes(origin)) {
       res.setHeader("Access-Control-Allow-Origin", origin);
       res.setHeader("Vary", "Origin");
     }
@@ -296,7 +304,7 @@ var MikroServe = class {
     res.setHeader("Access-Control-Max-Age", "86400");
   }
   /**
-   * Set security headers
+   * @description Set security headers.
    */
   setSecurityHeaders(res, isHttps = false) {
     res.setHeader("X-Content-Type-Options", "nosniff");
@@ -309,9 +317,7 @@ var MikroServe = class {
     res.setHeader("X-XSS-Protection", "1; mode=block");
   }
   /**
-   * Sends a response with appropriate headers.
-   * @param res - HTTP response object
-   * @param response - Response data and status code
+   * @description Sends a response with appropriate headers.
    */
   respond(res, response) {
     const headers = {
@@ -323,8 +329,7 @@ var MikroServe = class {
     else res.end(JSON.stringify(response.body));
   }
   /**
-   * Sets up graceful shutdown handlers for a server.
-   * @param server - The HTTP/HTTPS server to add shutdown handlers to
+   * @description Sets up graceful shutdown handlers for a server.
    */
   setupGracefulShutdown(server) {
     const shutdown = (error) => {
@@ -332,9 +337,7 @@ var MikroServe = class {
       if (error) console.error("Error:", error);
       server.close(() => {
         console.log("Server closed successfully");
-        setImmediate(() => {
-          process.exit(error ? 1 : 0);
-        });
+        setImmediate(() => process.exit(error ? 1 : 0));
       });
     };
     process.on("SIGINT", () => shutdown());

package/lib/chunk-CQPU7577.mjs

@@ -0,0 +1,9 @@
+// src/utils/getTruthyEnvValue.ts
+function getTruthyEnvValue(value) {
+  if (value === "true" || value === true) return true;
+  return false;
+}
+
+export {
+  getTruthyEnvValue
+};

package/lib/chunk-RP67R3W4.mjs

@@ -0,0 +1,43 @@
+import {
+  getTruthyEnvValue
+} from "./chunk-CQPU7577.mjs";
+
+// src/utils/configDefaults.ts
+var configDefaults = () => {
+  return {
+    port: Number(process.env.PORT) || 3e3,
+    host: process.env.HOST || "0.0.0.0",
+    useHttps: false,
+    sslCert: "",
+    sslKey: "",
+    sslCa: "",
+    debug: getTruthyEnvValue(process.env.DEBUG) || false,
+    rateLimit: {
+      enabled: true,
+      requestsPerMinute: 100
+    },
+    allowedDomains: ["*"]
+  };
+};
+var getDefaultConfig = () => {
+  const defaults = configDefaults();
+  return {
+    port: defaults.port,
+    host: defaults.host,
+    useHttps: defaults.useHttps,
+    sslCert: defaults.sslCert,
+    sslKey: defaults.sslKey,
+    sslCa: defaults.sslCa,
+    debug: defaults.debug,
+    rateLimit: {
+      enabled: defaults.rateLimit.enabled,
+      requestsPerMinute: defaults.rateLimit.requestsPerMinute
+    },
+    allowedDomains: defaults.allowedDomains
+  };
+};
+
+export {
+  configDefaults,
+  getDefaultConfig
+};

package/lib/index.d.mts

@@ -1,4 +1,5 @@
+#!/usr/bin/env node
 export { MikroServe } from './MikroServe.mjs';
+export { Context } from './interfaces/index.mjs';
 import 'node:http';
 import 'node:https';
-import './interfaces/index.mjs';

package/lib/index.d.ts

@@ -1,4 +1,5 @@
+#!/usr/bin/env node
 export { MikroServe } from './MikroServe.js';
+export { Context } from './interfaces/index.js';
 import 'node:http';
 import 'node:https';
-import './interfaces/index.js';