sprint-es 0.0.63 → 0.0.66

package/dist/cjs/index.cjs

@@ -163,18 +163,21 @@ class Sprint {
       this.routesLoaded = this.init();
       this.routesLoaded.then(() => {
         if (this.openapi.generateOnBuild) {
-          this.app.get("/openapi.json", (_, res) => {
-            res.json(this.generateOpenAPISpec());
-          });
           if (this.openapi.swaggerUi.enabled) {
+            console.log(`[Sprint] Loading Swagger UI...`);
             import("swagger-ui-express").then((swaggerUi) => {
+              console.log(`[Sprint] Swagger UI imported successfully`);
               this.app.use("/swagger", 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.`);
+              console.log(`[Sprint] Swagger UI mounted at /swagger`);
+            }).catch((err) => {
+              console.error(`[Sprint] ⚠️ swagger-ui-express error:`, err);
             });
           }
+          this.app.get("/openapi.json", (_, res) => {
+            res.json(this.generateOpenAPISpec());
+          });
         }
         if (finalConfig.autoListen) this.listen();
       });
@@ -428,7 +431,7 @@ class Sprint {
     for (const route of this.registeredRoutes || []) {
       const method = route.method.toLowerCase();
       if (!paths[route.path]) paths[route.path] = {};
-      paths[route.path][method] = {
+      const routeSpec = {
         summary: "Auto generated by Sprint",
         responses: {
           "200": {
@@ -436,6 +439,33 @@ class Sprint {
           }
         }
       };
+      if (route.schema?.body) {
+        try {
+          const bodySchema = this.zodSchemaToOpenAPI(route.schema.body);
+          if (Object.keys(bodySchema).length > 0) {
+            routeSpec.requestBody = {
+              content: {
+                "application/json": {
+                  schema: bodySchema
+                }
+              }
+            };
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert body schema:", e);
+        }
+      }
+      if (route.schema?.queryParams) {
+        try {
+          const params = this.zodParamsToOpenAPI(route.schema.queryParams);
+          if (params.length > 0) {
+            routeSpec.parameters = params;
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert query params schema:", e);
+        }
+      }
+      paths[route.path][method] = routeSpec;
     }
     return {
       openapi: "3.0.0",
@@ -446,6 +476,68 @@ class Sprint {
       paths
     };
   }
+  zodSchemaToOpenAPI(schema) {
+    if (!schema) return {};
+    if (schema._def?.typeName === "ZodObject" || schema.shape) {
+      const shape = schema.shape || schema._def?.shape();
+      if (!shape) return {};
+      const properties = {};
+      const required = [];
+      for (const [key, value] of Object.entries(shape)) {
+        const zodDef = value._def;
+        const typeName = zodDef?.typeName;
+        let propSchema = {};
+        if (typeName === "ZodString") {
+          propSchema = { type: "string" };
+        } else if (typeName === "ZodNumber") {
+          propSchema = { type: "number" };
+        } else if (typeName === "ZodBoolean") {
+          propSchema = { type: "boolean" };
+        } else if (typeName === "ZodArray") {
+          propSchema = { type: "array", items: this.zodSchemaToOpenAPI(zodDef?.type) };
+        } else if (typeName === "ZodObject") {
+          propSchema = this.zodSchemaToOpenAPI(zodDef?.type);
+        } else if (typeName === "ZodOptional") {
+          continue;
+        } else {
+          propSchema = { type: "string" };
+        }
+        properties[key] = propSchema;
+        if (!zodDef?.isOptional && typeName !== "ZodOptional") {
+          required.push(key);
+        }
+      }
+      return { type: "object", properties, required: required.length > 0 ? required : void 0 };
+    }
+    return {};
+  }
+  zodParamsToOpenAPI(schema) {
+    if (!schema) return [];
+    const params = [];
+    const shape = schema.shape || schema._def?.shape();
+    if (!shape) return [];
+    for (const [key, value] of Object.entries(shape)) {
+      const zodDef = value._def;
+      const typeName = zodDef?.typeName;
+      let paramSchema = {};
+      if (typeName === "ZodString") {
+        paramSchema = { type: "string" };
+      } else if (typeName === "ZodNumber") {
+        paramSchema = { type: "number" };
+      } else if (typeName === "ZodBoolean") {
+        paramSchema = { type: "boolean" };
+      } else {
+        paramSchema = { type: "string" };
+      }
+      params.push({
+        name: key,
+        in: "query",
+        required: !zodDef?.isOptional,
+        schema: paramSchema
+      });
+    }
+    return params;
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);

package/dist/esm/index.js

@@ -138,18 +138,21 @@ class Sprint {
       this.routesLoaded = this.init();
       this.routesLoaded.then(() => {
         if (this.openapi.generateOnBuild) {
-          this.app.get("/openapi.json", (_, res) => {
-            res.json(this.generateOpenAPISpec());
-          });
           if (this.openapi.swaggerUi.enabled) {
+            console.log(`[Sprint] Loading Swagger UI...`);
             import("swagger-ui-express").then((swaggerUi) => {
+              console.log(`[Sprint] Swagger UI imported successfully`);
               this.app.use("/swagger", 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.`);
+              console.log(`[Sprint] Swagger UI mounted at /swagger`);
+            }).catch((err) => {
+              console.error(`[Sprint] ⚠️ swagger-ui-express error:`, err);
             });
           }
+          this.app.get("/openapi.json", (_, res) => {
+            res.json(this.generateOpenAPISpec());
+          });
         }
         if (finalConfig.autoListen) this.listen();
       });
@@ -403,7 +406,7 @@ class Sprint {
     for (const route of this.registeredRoutes || []) {
       const method = route.method.toLowerCase();
       if (!paths[route.path]) paths[route.path] = {};
-      paths[route.path][method] = {
+      const routeSpec = {
         summary: "Auto generated by Sprint",
         responses: {
           "200": {
@@ -411,6 +414,33 @@ class Sprint {
           }
         }
       };
+      if (route.schema?.body) {
+        try {
+          const bodySchema = this.zodSchemaToOpenAPI(route.schema.body);
+          if (Object.keys(bodySchema).length > 0) {
+            routeSpec.requestBody = {
+              content: {
+                "application/json": {
+                  schema: bodySchema
+                }
+              }
+            };
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert body schema:", e);
+        }
+      }
+      if (route.schema?.queryParams) {
+        try {
+          const params = this.zodParamsToOpenAPI(route.schema.queryParams);
+          if (params.length > 0) {
+            routeSpec.parameters = params;
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert query params schema:", e);
+        }
+      }
+      paths[route.path][method] = routeSpec;
     }
     return {
       openapi: "3.0.0",
@@ -421,6 +451,68 @@ class Sprint {
       paths
     };
   }
+  zodSchemaToOpenAPI(schema) {
+    if (!schema) return {};
+    if (schema._def?.typeName === "ZodObject" || schema.shape) {
+      const shape = schema.shape || schema._def?.shape();
+      if (!shape) return {};
+      const properties = {};
+      const required = [];
+      for (const [key, value] of Object.entries(shape)) {
+        const zodDef = value._def;
+        const typeName = zodDef?.typeName;
+        let propSchema = {};
+        if (typeName === "ZodString") {
+          propSchema = { type: "string" };
+        } else if (typeName === "ZodNumber") {
+          propSchema = { type: "number" };
+        } else if (typeName === "ZodBoolean") {
+          propSchema = { type: "boolean" };
+        } else if (typeName === "ZodArray") {
+          propSchema = { type: "array", items: this.zodSchemaToOpenAPI(zodDef?.type) };
+        } else if (typeName === "ZodObject") {
+          propSchema = this.zodSchemaToOpenAPI(zodDef?.type);
+        } else if (typeName === "ZodOptional") {
+          continue;
+        } else {
+          propSchema = { type: "string" };
+        }
+        properties[key] = propSchema;
+        if (!zodDef?.isOptional && typeName !== "ZodOptional") {
+          required.push(key);
+        }
+      }
+      return { type: "object", properties, required: required.length > 0 ? required : void 0 };
+    }
+    return {};
+  }
+  zodParamsToOpenAPI(schema) {
+    if (!schema) return [];
+    const params = [];
+    const shape = schema.shape || schema._def?.shape();
+    if (!shape) return [];
+    for (const [key, value] of Object.entries(shape)) {
+      const zodDef = value._def;
+      const typeName = zodDef?.typeName;
+      let paramSchema = {};
+      if (typeName === "ZodString") {
+        paramSchema = { type: "string" };
+      } else if (typeName === "ZodNumber") {
+        paramSchema = { type: "number" };
+      } else if (typeName === "ZodBoolean") {
+        paramSchema = { type: "boolean" };
+      } else {
+        paramSchema = { type: "string" };
+      }
+      params.push({
+        name: key,
+        in: "query",
+        required: !zodDef?.isOptional,
+        schema: paramSchema
+      });
+    }
+    return params;
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);

package/dist/types/sprint.d.ts

@@ -34,6 +34,8 @@ export declare class Sprint {
     /** Applies prefix to a path */
     private applyPrefix;
     private generateOpenAPISpec;
+    private zodSchemaToOpenAPI;
+    private zodParamsToOpenAPI;
     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,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;AAwCnC,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;;YAoEM,IAAI;IAkClB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YAoFV,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;CA0DzC"}
+{"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;AAwCnC,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;;YAwEM,IAAI;IAkClB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YAoFV,YAAY;IAmB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA4D3B,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,kBAAkB;IAoCnB,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;CA0DzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sprint-es",
-  "version": "0.0.63",
+  "version": "0.0.66",
   "description": "Sprint - Quickly API",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",