sprint-es 0.0.52 → 0.0.56

package/dist/cjs/cli.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 "use strict";
-const child_process = require("child_process");
 const fs = require("fs");
 const crypto = require("crypto");
 const path = require("path");
+const child_process = require("child_process");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
   if (e) {
@@ -48,9 +48,7 @@ if (command === "--help" || command === "-h") {
 function getProjectRoot() {
   let dir = process.cwd();
   while (dir !== path.resolve(dir, "..")) {
-    if (fs.existsSync(path.join(dir, "sprint.config.ts")) || fs.existsSync(path.join(dir, "sprint.config.js"))) {
-      return dir;
-    }
+    if (fs.existsSync(path.join(dir, "sprint.config.ts")) || fs.existsSync(path.join(dir, "sprint.config.js"))) return dir;
     dir = path.resolve(dir, "..");
   }
   return process.cwd();

package/dist/cjs/index.cjs

@@ -1,4 +1,26 @@
 "use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
 const express = require("express");
 const fs = require("fs");
@@ -51,31 +73,103 @@ const limiter = new rateLimit.RateLimiter({
 });
 const isDevelopment = isDev;
 const isProduction = isProd;
+async function findProjectRoot(startDir) {
+  let currentDir = startDir;
+  while (currentDir !== path.parse(currentDir).root) {
+    const packageJsonPath = path.join(currentDir, "package.json");
+    if (fs.existsSync(packageJsonPath)) return currentDir;
+    currentDir = path.dirname(currentDir);
+  }
+  return null;
+}
+async function loadSprintConfig() {
+  const callerDir = process.argv[1] ? path.dirname(process.argv[1]) : process.cwd();
+  const projectRoot = await findProjectRoot(callerDir);
+  if (!projectRoot) return null;
+  const configFiles = ["sprint.config.ts", "sprint.config.js"];
+  for (const configFile of configFiles) {
+    const configPath = path.join(projectRoot, configFile);
+    if (fs.existsSync(configPath)) {
+      try {
+        const moduleUrl = url.pathToFileURL(configPath).href;
+        const config = await import(moduleUrl);
+        return config.default || config;
+      } catch (err) {
+        console.warn(`[Sprint] Failed to load config from ${configPath}:`, err);
+      }
+    }
+  }
+  return null;
+}
 class Sprint {
-  constructor({
-    port = process.env.PORT,
-    routesPath = "./routes",
-    middlewaresPath = "./middlewares",
-    cronjobsPath = "./cronjobs",
-    jsonLimit = "50mb",
-    urlEncodedLimit = "50mb",
-    prefix = "",
-    autoListen = true
-  } = {}) {
+  constructor() {
+    this.port = process.env.PORT;
+    this.routesPath = "./routes";
+    this.middlewaresPath = "./middlewares";
+    this.cronjobsPath = "./cronjobs";
+    this.jsonLimit = "50mb";
+    this.urlEncodedLimit = "50mb";
+    this.prefix = "";
     this.loadedMiddlewares = [];
+    this.openapi = {
+      generateOnBuild: false,
+      swaggerUi: {
+        enabled: false
+      }
+    };
+    this.registeredRoutes = [];
     this.app = express();
-    this.port = port;
-    this.routesPath = routesPath;
-    this.middlewaresPath = middlewaresPath;
-    this.cronjobsPath = cronjobsPath;
-    this.jsonLimit = jsonLimit;
-    this.urlEncodedLimit = urlEncodedLimit;
-    this.prefix = prefix ? "/" + prefix.replace(/^\/+|\/+$/g, "") : "";
-    this.server = http.createServer(this.app);
-    this.loadDefaults();
-    this.loadHealthcheck();
-    this.routesLoaded = this.init();
-    if (autoListen) this.routesLoaded.then(() => this.listen());
+    loadSprintConfig().then((config) => {
+      const defaults = {
+        port: process.env.PORT,
+        routesPath: "./routes",
+        middlewaresPath: "./middlewares",
+        cronjobsPath: "./cronjobs",
+        jsonLimit: "50mb",
+        urlEncodedLimit: "50mb",
+        prefix: "",
+        autoListen: true,
+        openapi: {
+          generateOnBuild: false,
+          swaggerUi: {
+            enabled: false
+          }
+        }
+      };
+      const finalConfig = { ...defaults, ...config };
+      this.port = finalConfig.port;
+      this.routesPath = finalConfig.routesPath || "./routes";
+      this.middlewaresPath = finalConfig.middlewaresPath || "./middlewares";
+      this.cronjobsPath = finalConfig.cronjobsPath || "./cronjobs";
+      this.jsonLimit = finalConfig.jsonLimit || "50mb";
+      this.urlEncodedLimit = finalConfig.urlEncodedLimit || "50mb";
+      this.prefix = finalConfig.prefix ? "/" + finalConfig.prefix.replace(/^\/+|\/+$/g, "") : "";
+      this.openapi = {
+        generateOnBuild: finalConfig.openapi?.generateOnBuild ?? false,
+        swaggerUi: {
+          enabled: finalConfig.openapi?.swaggerUi?.enabled ?? false
+        }
+      };
+      if (this.openapi.generateOnBuild === true) console.log(`[Sprint] ⚠️ openapi.generateOnBuild is enabled but this option makes nothing for now`);
+      this.loadDefaults();
+      this.loadHealthcheck();
+      this.routesLoaded = this.init();
+      if (this.openapi.generateOnBuild) {
+        this.app.get("/openapi.json", (_, res) => {
+          res.json(this.generateOpenAPISpec());
+        });
+        if (finalConfig.openapi?.swaggerUi?.enabled) {
+          import("swagger-ui-express").then((swaggerUi) => {
+            this.app.use("/docs", swaggerUi.serve, swaggerUi.setup(void 0, {
+              swaggerUrl: "/openapi.json"
+            }));
+          }).catch(() => {
+            console.error(`[Sprint] ⚠️ swagger-ui-express is not installed. Run "npm install swagger-ui-express" to enable Swagger UI.`);
+          });
+        }
+      }
+      if (finalConfig.autoListen) this.routesLoaded.then(() => this.listen());
+    });
   }
   async init() {
     const callerDir = process.argv[1] ? path.dirname(process.argv[1]) : process.cwd();
@@ -224,6 +318,24 @@ class Sprint {
               if (routePath.endsWith("/index")) routePath = routePath.slice(0, -6) || "/";
               const fullRoute = this.prefix + (routePath === "/" ? "" : routePath);
               const finalRoute = fullRoute || "/";
+              if (this.openapi.generateOnBuild) {
+                if (!this.registeredRoutes) this.registeredRoutes = [];
+                for (const layer of router.stack) {
+                  if (!layer.route) continue;
+                  const route = layer.route;
+                  for (const routeLayer of route.stack) {
+                    const schema = routeLayer.handle.__sprintRouteSchema;
+                    if (!schema) continue;
+                    const method = (routeLayer.method || "").toUpperCase();
+                    if (!method) continue;
+                    this.registeredRoutes.push({
+                      method,
+                      path: finalRoute + route.path,
+                      schema
+                    });
+                  }
+                }
+              }
               const routeMiddlewares = this.getMiddlewaresForRoute(routePath);
               if (routeMiddlewares.length > 0) {
                 this.app.use(finalRoute, ...routeMiddlewares, router);
@@ -292,6 +404,29 @@ class Sprint {
     if (!this.prefix) return routePath;
     return this.prefix + (routePath.startsWith("/") ? routePath : "/" + routePath);
   }
+  generateOpenAPISpec() {
+    const paths = {};
+    for (const route of this.registeredRoutes || []) {
+      const method = route.method.toLowerCase();
+      if (!paths[route.path]) paths[route.path] = {};
+      paths[route.path][method] = {
+        summary: "Auto generated by Sprint",
+        responses: {
+          "200": {
+            description: "Success"
+          }
+        }
+      };
+    }
+    return {
+      openapi: "3.0.0",
+      info: {
+        title: "Sprint API",
+        version: "1.0.0"
+      },
+      paths
+    };
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);
@@ -309,9 +444,7 @@ class Sprint {
     return this.app.patch(this.applyPrefix(path2), handler);
   }
   use(pathOrHandler, maybeHandler) {
-    if (typeof pathOrHandler === "string" && maybeHandler) {
-      return this.app.use(this.applyPrefix(pathOrHandler), maybeHandler);
-    }
+    if (typeof pathOrHandler === "string" && maybeHandler) return this.app.use(this.applyPrefix(pathOrHandler), maybeHandler);
     if (pathOrHandler && typeof pathOrHandler === "object" && "handler" in pathOrHandler) {
       const config = pathOrHandler;
       const handlers = Array.isArray(config.handler) ? config.handler : [config.handler];
@@ -326,6 +459,7 @@ class Sprint {
     let serverStarted = false;
     const tryListen = (port) => {
       triedPorts.push(port);
+      this.server = http.createServer(this.app);
       this.server.listen(port, () => {
         serverStarted = true;
         const prefixInfo = this.prefix ? this.prefix : "/";

package/dist/cjs/modules/schemas/index.cjs

@@ -15,31 +15,25 @@ function parseSchema(schema, data) {
   return { success: true, data: result.data };
 }
 function defineRouteSchema(schema) {
-  return (req, res, next) => {
+  const middleware = (req, res, next) => {
     const errors = [];
-    if (schema.body && req.body) {
+    if (schema.body) {
       const result = parseSchema(schema.body, req.body);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "body", ...e })));
-      }
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "body", ...e })));
     }
-    if (schema.queryParams && req.query) {
+    if (schema.queryParams) {
       const result = parseSchema(schema.queryParams, req.query);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "queryParams", ...e })));
-      }
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "queryParams", ...e })));
     }
-    if (schema.params && req.params) {
+    if (schema.params) {
       const result = parseSchema(schema.params, req.params);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
-      }
-    }
-    if (errors.length > 0) {
-      return res.status(400).json({ error: "Validation failed", details: errors });
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
     }
+    if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
     next();
   };
+  middleware.__sprintRouteSchema = schema;
+  return middleware;
 }
 Object.defineProperty(exports, "z", {
   enumerable: true,

package/dist/esm/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { spawn } from "child_process";
 import { existsSync } from "fs";
 import * as crypto from "crypto";
 import { join, resolve } from "path";
+import { spawn } from "child_process";
 const args = process.argv.slice(2);
 const command = args[0];
 if (!command) {
@@ -30,9 +30,7 @@ if (command === "--help" || command === "-h") {
 function getProjectRoot() {
   let dir = process.cwd();
   while (dir !== resolve(dir, "..")) {
-    if (existsSync(join(dir, "sprint.config.ts")) || existsSync(join(dir, "sprint.config.js"))) {
-      return dir;
-    }
+    if (existsSync(join(dir, "sprint.config.ts")) || existsSync(join(dir, "sprint.config.js"))) return dir;
     dir = resolve(dir, "..");
   }
   return process.cwd();

package/dist/esm/index.js

@@ -48,31 +48,103 @@ const limiter = new RateLimiter({
 });
 const isDevelopment = isDev;
 const isProduction = isProd;
+async function findProjectRoot(startDir) {
+  let currentDir = startDir;
+  while (currentDir !== path.parse(currentDir).root) {
+    const packageJsonPath = path.join(currentDir, "package.json");
+    if (fs.existsSync(packageJsonPath)) return currentDir;
+    currentDir = path.dirname(currentDir);
+  }
+  return null;
+}
+async function loadSprintConfig() {
+  const callerDir = process.argv[1] ? path.dirname(process.argv[1]) : process.cwd();
+  const projectRoot = await findProjectRoot(callerDir);
+  if (!projectRoot) return null;
+  const configFiles = ["sprint.config.ts", "sprint.config.js"];
+  for (const configFile of configFiles) {
+    const configPath = path.join(projectRoot, configFile);
+    if (fs.existsSync(configPath)) {
+      try {
+        const moduleUrl = pathToFileURL(configPath).href;
+        const config = await import(moduleUrl);
+        return config.default || config;
+      } catch (err) {
+        console.warn(`[Sprint] Failed to load config from ${configPath}:`, err);
+      }
+    }
+  }
+  return null;
+}
 class Sprint {
-  constructor({
-    port = process.env.PORT,
-    routesPath = "./routes",
-    middlewaresPath = "./middlewares",
-    cronjobsPath = "./cronjobs",
-    jsonLimit = "50mb",
-    urlEncodedLimit = "50mb",
-    prefix = "",
-    autoListen = true
-  } = {}) {
+  constructor() {
+    this.port = process.env.PORT;
+    this.routesPath = "./routes";
+    this.middlewaresPath = "./middlewares";
+    this.cronjobsPath = "./cronjobs";
+    this.jsonLimit = "50mb";
+    this.urlEncodedLimit = "50mb";
+    this.prefix = "";
     this.loadedMiddlewares = [];
+    this.openapi = {
+      generateOnBuild: false,
+      swaggerUi: {
+        enabled: false
+      }
+    };
+    this.registeredRoutes = [];
     this.app = express();
-    this.port = port;
-    this.routesPath = routesPath;
-    this.middlewaresPath = middlewaresPath;
-    this.cronjobsPath = cronjobsPath;
-    this.jsonLimit = jsonLimit;
-    this.urlEncodedLimit = urlEncodedLimit;
-    this.prefix = prefix ? "/" + prefix.replace(/^\/+|\/+$/g, "") : "";
-    this.server = http.createServer(this.app);
-    this.loadDefaults();
-    this.loadHealthcheck();
-    this.routesLoaded = this.init();
-    if (autoListen) this.routesLoaded.then(() => this.listen());
+    loadSprintConfig().then((config) => {
+      const defaults = {
+        port: process.env.PORT,
+        routesPath: "./routes",
+        middlewaresPath: "./middlewares",
+        cronjobsPath: "./cronjobs",
+        jsonLimit: "50mb",
+        urlEncodedLimit: "50mb",
+        prefix: "",
+        autoListen: true,
+        openapi: {
+          generateOnBuild: false,
+          swaggerUi: {
+            enabled: false
+          }
+        }
+      };
+      const finalConfig = { ...defaults, ...config };
+      this.port = finalConfig.port;
+      this.routesPath = finalConfig.routesPath || "./routes";
+      this.middlewaresPath = finalConfig.middlewaresPath || "./middlewares";
+      this.cronjobsPath = finalConfig.cronjobsPath || "./cronjobs";
+      this.jsonLimit = finalConfig.jsonLimit || "50mb";
+      this.urlEncodedLimit = finalConfig.urlEncodedLimit || "50mb";
+      this.prefix = finalConfig.prefix ? "/" + finalConfig.prefix.replace(/^\/+|\/+$/g, "") : "";
+      this.openapi = {
+        generateOnBuild: finalConfig.openapi?.generateOnBuild ?? false,
+        swaggerUi: {
+          enabled: finalConfig.openapi?.swaggerUi?.enabled ?? false
+        }
+      };
+      if (this.openapi.generateOnBuild === true) console.log(`[Sprint] ⚠️ openapi.generateOnBuild is enabled but this option makes nothing for now`);
+      this.loadDefaults();
+      this.loadHealthcheck();
+      this.routesLoaded = this.init();
+      if (this.openapi.generateOnBuild) {
+        this.app.get("/openapi.json", (_, res) => {
+          res.json(this.generateOpenAPISpec());
+        });
+        if (finalConfig.openapi?.swaggerUi?.enabled) {
+          import("swagger-ui-express").then((swaggerUi) => {
+            this.app.use("/docs", swaggerUi.serve, swaggerUi.setup(void 0, {
+              swaggerUrl: "/openapi.json"
+            }));
+          }).catch(() => {
+            console.error(`[Sprint] ⚠️ swagger-ui-express is not installed. Run "npm install swagger-ui-express" to enable Swagger UI.`);
+          });
+        }
+      }
+      if (finalConfig.autoListen) this.routesLoaded.then(() => this.listen());
+    });
   }
   async init() {
     const callerDir = process.argv[1] ? path.dirname(process.argv[1]) : process.cwd();
@@ -221,6 +293,24 @@ class Sprint {
               if (routePath.endsWith("/index")) routePath = routePath.slice(0, -6) || "/";
               const fullRoute = this.prefix + (routePath === "/" ? "" : routePath);
               const finalRoute = fullRoute || "/";
+              if (this.openapi.generateOnBuild) {
+                if (!this.registeredRoutes) this.registeredRoutes = [];
+                for (const layer of router.stack) {
+                  if (!layer.route) continue;
+                  const route = layer.route;
+                  for (const routeLayer of route.stack) {
+                    const schema = routeLayer.handle.__sprintRouteSchema;
+                    if (!schema) continue;
+                    const method = (routeLayer.method || "").toUpperCase();
+                    if (!method) continue;
+                    this.registeredRoutes.push({
+                      method,
+                      path: finalRoute + route.path,
+                      schema
+                    });
+                  }
+                }
+              }
               const routeMiddlewares = this.getMiddlewaresForRoute(routePath);
               if (routeMiddlewares.length > 0) {
                 this.app.use(finalRoute, ...routeMiddlewares, router);
@@ -289,6 +379,29 @@ class Sprint {
     if (!this.prefix) return routePath;
     return this.prefix + (routePath.startsWith("/") ? routePath : "/" + routePath);
   }
+  generateOpenAPISpec() {
+    const paths = {};
+    for (const route of this.registeredRoutes || []) {
+      const method = route.method.toLowerCase();
+      if (!paths[route.path]) paths[route.path] = {};
+      paths[route.path][method] = {
+        summary: "Auto generated by Sprint",
+        responses: {
+          "200": {
+            description: "Success"
+          }
+        }
+      };
+    }
+    return {
+      openapi: "3.0.0",
+      info: {
+        title: "Sprint API",
+        version: "1.0.0"
+      },
+      paths
+    };
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);
@@ -306,9 +419,7 @@ class Sprint {
     return this.app.patch(this.applyPrefix(path2), handler);
   }
   use(pathOrHandler, maybeHandler) {
-    if (typeof pathOrHandler === "string" && maybeHandler) {
-      return this.app.use(this.applyPrefix(pathOrHandler), maybeHandler);
-    }
+    if (typeof pathOrHandler === "string" && maybeHandler) return this.app.use(this.applyPrefix(pathOrHandler), maybeHandler);
     if (pathOrHandler && typeof pathOrHandler === "object" && "handler" in pathOrHandler) {
       const config = pathOrHandler;
       const handlers = Array.isArray(config.handler) ? config.handler : [config.handler];
@@ -323,6 +434,7 @@ class Sprint {
     let serverStarted = false;
     const tryListen = (port) => {
       triedPorts.push(port);
+      this.server = http.createServer(this.app);
       this.server.listen(port, () => {
         serverStarted = true;
         const prefixInfo = this.prefix ? this.prefix : "/";

package/dist/esm/modules/schemas/index.js

@@ -13,31 +13,25 @@ function parseSchema(schema, data) {
   return { success: true, data: result.data };
 }
 function defineRouteSchema(schema) {
-  return (req, res, next) => {
+  const middleware = (req, res, next) => {
     const errors = [];
-    if (schema.body && req.body) {
+    if (schema.body) {
       const result = parseSchema(schema.body, req.body);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "body", ...e })));
-      }
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "body", ...e })));
     }
-    if (schema.queryParams && req.query) {
+    if (schema.queryParams) {
       const result = parseSchema(schema.queryParams, req.query);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "queryParams", ...e })));
-      }
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "queryParams", ...e })));
     }
-    if (schema.params && req.params) {
+    if (schema.params) {
       const result = parseSchema(schema.params, req.params);
-      if (!result.success) {
-        errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
-      }
-    }
-    if (errors.length > 0) {
-      return res.status(400).json({ error: "Validation failed", details: errors });
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
     }
+    if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
     next();
   };
+  middleware.__sprintRouteSchema = schema;
+  return middleware;
 }
 export {
   defineRouteSchema,

package/dist/types/modules/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,UAAU,EAAY,MAAM,KAAK,CAAC;AAE1E,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;CAChD;AAqBD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,cAAc,CA+BzF;AAED,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,UAAU,EAAY,MAAM,KAAK,CAAC;AAE1E,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;CAChD;AAqBD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,cAAc,CA4BzF;AAED,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/sprint.d.ts

@@ -1,4 +1,4 @@
-import { Handler, SprintOptions, MiddlewareConfig } from './types';
+import { Handler, MiddlewareConfig } from './types';
 import { default as express, Application } from 'express';
 export declare const isDevelopment: boolean;
 export declare const isProduction: boolean;
@@ -14,7 +14,9 @@ export declare class Sprint {
     private routesLoaded;
     private server;
     private loadedMiddlewares;
-    constructor({ port, routesPath, middlewaresPath, cronjobsPath, jsonLimit, urlEncodedLimit, prefix, autoListen }?: SprintOptions);
+    private openapi;
+    private registeredRoutes;
+    constructor();
     private init;
     private loadDefaults;
     /**
@@ -31,6 +33,7 @@ export declare class Sprint {
     private loadNotFound;
     /** Applies prefix to a path */
     private applyPrefix;
+    private generateOpenAPISpec;
     get(path: string, handler: Handler): express.Application;
     post(path: string, handler: Handler): express.Application;
     put(path: string, handler: Handler): express.Application;

package/dist/types/sprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../src/sprint.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAoB,MAAM,SAAS,CAAC;AACrF,OAAO,OAAO,EAAE,EAAE,WAAW,EAAoD,MAAM,SAAS,CAAC;AAejG,eAAO,MAAM,aAAa,SAAQ,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,qBAAa,MAAM;IACR,GAAG,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,iBAAiB,CAA0B;gBAEvC,EACR,IAAuB,EACvB,UAAuB,EACvB,eAAiC,EACjC,YAA2B,EAC3B,SAAkB,EAClB,eAAwB,EACxB,MAAW,EACX,UAAiB,EACpB,GAAE,aAAkB;YAkBP,IAAI;IA+BlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YAgDV,YAAY;IAmB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAMZ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACpC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO;IAclF,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;CAsDzC"}
+{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../src/sprint.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAA+B,gBAAgB,EAAoB,MAAM,SAAS,CAAC;AACnG,OAAO,OAAO,EAAE,EAAE,WAAW,EAAoD,MAAM,SAAS,CAAC;AAejG,eAAO,MAAM,aAAa,SAAQ,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AAoCnC,qBAAa,MAAM;IACR,GAAG,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,IAAI,CAAwD;IACpE,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,OAAO,CAUb;IACF,OAAO,CAAC,gBAAgB,CAIhB;;YAkEM,IAAI;IA+BlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YA2EV,YAAY;IAmB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA6BpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACpC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO;IAYlF,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;CAwDzC"}

package/dist/types/types.d.ts

@@ -67,6 +67,30 @@ export interface SprintOptions {
     prefix?: string;
     /** Auto-start the server. Default: true */
     autoListen?: boolean;
+    openapi?: {
+        enabled?: boolean;
+        generateOnBuild?: boolean;
+        swaggerUi?: {
+            enabled?: boolean;
+        };
+    };
+}
+export interface SprintConfig {
+    port?: string | number | null;
+    routesPath?: string;
+    middlewaresPath?: string;
+    cronjobsPath?: string;
+    jsonLimit?: string;
+    urlEncodedLimit?: string;
+    prefix?: string;
+    autoListen?: boolean;
+    openapi?: {
+        enabled?: boolean;
+        generateOnBuild?: boolean;
+        swaggerUi?: {
+            enabled?: boolean;
+        };
+    };
 }
 export type { NextFunction } from 'express';
 //# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEpG,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,GAAG,CAAC;AAE/E,MAAM,MAAM,mBAAmB,GACzB,SAAS,MAAM,EAAE,GACjB,WAAW,MAAM,EAAE,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC1B,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;CACnG;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,OAAO,CAAC;QACd,UAAU,OAAO;YACb,MAAM,EAAE,aAAa,CAAC;YAEtB,MAAM,EAAE,GAAG,CAAC;SACf;KACJ;CACJ;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oFAAoF;IACpF,OAAO,EAAE,cAAc,GAAG,mBAAmB,GAAG,CAAC,cAAc,GAAG,mBAAmB,CAAC,EAAE,CAAC;IACzF;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sprint-es",
-  "version": "0.0.52",
+  "version": "0.0.56",
   "description": "Sprint - Quickly API",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -103,6 +103,7 @@
     "@types/node": "^22.18.7",
     "@types/node-cron": "^3.0.11",
     "@types/serve-favicon": "^2.5.7",
+    "@types/swagger-ui-express": "^4.1.8",
     "jest": "^30.1.3",
     "rimraf": "^6.0.1",
     "ts-jest": "^29.4.4",
@@ -111,6 +112,9 @@
     "vite": "^6.4.1",
     "vite-plugin-dts": "^4.5.4"
   },
+  "optionalDependencies": {
+    "swagger-ui-express": "^5.0.1"
+  },
   "prettier": {
     "tabWidth": 4,
     "useTabs": false