sprint-es 0.0.74 → 0.0.76

package/dist/cjs/index.cjs

@@ -439,6 +439,7 @@ class Sprint {
           }
         }
       };
+      let allParams = [];
       if (route.schema?.body && !["GET", "HEAD", "DELETE"].includes(route.method)) {
         try {
           const bodySchema = this.zodSchemaToOpenAPI(route.schema.body);
@@ -458,11 +459,81 @@ class Sprint {
       if (route.schema?.queryParams) {
         try {
           const params = this.zodParamsToOpenAPI(route.schema.queryParams);
-          if (params.length > 0) routeSpec.parameters = params;
+          if (params.length > 0) allParams.push(...params);
         } catch (e) {
           console.warn("[Sprint] Failed to convert query params schema:", e);
         }
       }
+      if (route.schema?.headers) {
+        try {
+          const headers = this.zodHeadersToOpenAPI(route.schema.headers);
+          if (headers.length > 0) allParams.push(...headers);
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert headers schema:", e);
+        }
+      }
+      if (this.openapi.generateOnBuild) {
+        try {
+          const routeMiddlewares = this.getMiddlewaresForRoute(route.path);
+          for (const mw of this.loadedMiddlewares) {
+            const includePatterns = Array.isArray(mw.include) ? mw.include : [mw.include || "/**"];
+            const excludePatterns = Array.isArray(mw.exclude) ? mw.exclude : mw.exclude ? [mw.exclude] : [];
+            const isIncluded = matchesPatterns(includePatterns, route.path);
+            const isExcluded = excludePatterns.length > 0 && matchesPatterns(excludePatterns, route.path);
+            if (isIncluded && !isExcluded && mw.__sprintMiddlewareSchema) {
+              const mwSchema = mw.__sprintMiddlewareSchema;
+              if (mwSchema.queryParams) {
+                const params = this.zodParamsToOpenAPI(mwSchema.queryParams);
+                if (params.length > 0) allParams.push(...params);
+              }
+              if (mwSchema.headers) {
+                const headers = this.zodHeadersToOpenAPI(mwSchema.headers);
+                if (headers.length > 0) allParams.push(...headers);
+              }
+              if (mwSchema.sprint?.authorization) {
+                const authSchema = mwSchema.sprint.authorization;
+                const description = authSchema._def?.description;
+                let sources = ["query:token", "headers:authorization"];
+                if (description) {
+                  try {
+                    const parsed = JSON.parse(description);
+                    if (parsed.__sprintAuthorization && parsed.sources) {
+                      sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+                    }
+                  } catch {
+                  }
+                }
+                for (const source of sources) {
+                  const [type, key] = source.split(":");
+                  if (type === "query") {
+                    allParams.push({
+                      name: key,
+                      in: "query",
+                      required: true,
+                      schema: { type: "string" }
+                    });
+                  } else if (type === "headers") {
+                    allParams.push({
+                      name: key,
+                      in: "header",
+                      required: true,
+                      schema: { type: "string" }
+                    });
+                  }
+                }
+              }
+            }
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to add middleware schemas to OpenAPI:", e);
+        }
+      }
+      if (allParams.length > 0) {
+        const uniqueParams = allParams.filter(
+          (param, index, self) => index === self.findIndex((p) => p.name === param.name && p.in === param.in)
+        );
+        routeSpec.parameters = uniqueParams;
+      }
       paths[route.path][method] = routeSpec;
     }
     return {
@@ -536,6 +607,33 @@ class Sprint {
     }
     return params;
   }
+  zodHeadersToOpenAPI(schema) {
+    if (!schema) return [];
+    const headers = [];
+    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" };
+      }
+      headers.push({
+        name: key,
+        in: "header",
+        required: !zodDef?.isOptional,
+        schema: paramSchema
+      });
+    }
+    return headers;
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);
@@ -612,6 +710,88 @@ class Sprint {
     });
   }
 }
+function createSchemaValidationMiddleware(schema) {
+  return (req, res, next) => {
+    const errors = [];
+    if (schema.body) {
+      const result = schema.body.safeParse(req.body);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "body",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.queryParams) {
+      const result = schema.queryParams.safeParse(req.query);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "queryParams",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.params) {
+      const result = schema.params.safeParse(req.params);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "params",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.headers) {
+      const result = schema.headers.safeParse(req.headers);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "headers",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.sprint?.authorization) {
+      const authSchema = schema.sprint.authorization;
+      const description = authSchema._def?.description;
+      let sources = ["query:token", "headers:authorization"];
+      if (description) {
+        try {
+          const parsed = JSON.parse(description);
+          if (parsed.__sprintAuthorization && parsed.sources) sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+        } catch {
+        }
+      }
+      let authValue;
+      for (const source of sources) {
+        const [type, key] = source.split(":");
+        if (type === "query") {
+          const value = req.query[key];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+        } else if (type === "headers") {
+          const value = req.headers[key.toLowerCase()];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+          if (Array.isArray(value) && value.length > 0 && typeof value[0] === "string" && value[0].length > 0) {
+            authValue = value[0];
+            break;
+          }
+        }
+      }
+      if (!authValue) errors.push({ location: "sprint.authorization", path: "authorization", message: "Authorization header or query parameter not found" });
+      else req.sprint.authorization = authValue;
+    }
+    if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
+    next();
+  };
+}
 function defineMiddleware(config) {
   const wrapHandler = (handler) => {
     return (req, res, next) => {
@@ -619,10 +799,24 @@ function defineMiddleware(config) {
       if (result instanceof Promise) result.catch(next);
     };
   };
-  return {
+  const handlers = [];
+  if (config.schema) {
+    handlers.push(createSchemaValidationMiddleware(config.schema));
+  }
+  const originalHandler = config.handler;
+  if (Array.isArray(originalHandler)) {
+    handlers.push(...originalHandler.map(wrapHandler));
+  } else {
+    handlers.push(wrapHandler(originalHandler));
+  }
+  const finalConfig = {
     ...config,
-    handler: Array.isArray(config.handler) ? config.handler.map(wrapHandler) : wrapHandler(config.handler)
+    handler: handlers
   };
+  if (config.schema) {
+    finalConfig.__sprintMiddlewareSchema = config.schema;
+  }
+  return finalConfig;
 }
 const Router = () => express.Router();
 exports.Router = Router;

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

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const zod = require("zod");
+function createSprintAuthorizationSchema(options) {
+  const defaultSources = ["query:token", "headers:authorization"];
+  const sources = options?.sources ? Array.isArray(options.sources) ? options.sources : [options.sources] : defaultSources;
+  return zod.z.string().describe(JSON.stringify({ __sprintAuthorization: true, sources }));
+}
+const sprintBuilder = {
+  authorization: createSprintAuthorizationSchema
+};
+zod.z.sprint = sprintBuilder;
+const sprint = sprintBuilder;
 function parseSchema(schema, data) {
   const result = schema.safeParse(data);
   if (!result.success) {
@@ -29,6 +39,47 @@ function defineRouteSchema(schema) {
       const result = parseSchema(schema.params, req.params);
       if (!result.success) errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
     }
+    if (schema.headers) {
+      const result = parseSchema(schema.headers, req.headers);
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "headers", ...e })));
+    }
+    if (schema.sprint?.authorization) {
+      const authSchema = schema.sprint.authorization;
+      const description = authSchema._def?.description;
+      let sources = ["query:token", "headers:authorization"];
+      if (description) {
+        try {
+          const parsed = JSON.parse(description);
+          if (parsed.__sprintAuthorization && parsed.sources) {
+            sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+          }
+        } catch {
+        }
+      }
+      let authValue;
+      for (const source of sources) {
+        const [type, key] = source.split(":");
+        if (type === "query") {
+          const value = req.query[key];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+        } else if (type === "headers") {
+          const value = req.headers[key.toLowerCase()];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+          if (Array.isArray(value) && value.length > 0 && typeof value[0] === "string" && value[0].length > 0) {
+            authValue = value[0];
+            break;
+          }
+        }
+      }
+      if (!authValue) errors.push({ location: "sprint.authorization", path: "authorization", message: "Authorization header or query parameter not found" });
+      else req.sprint.authorization = authValue;
+    }
     if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
     next();
   };
@@ -40,3 +91,4 @@ Object.defineProperty(exports, "z", {
   get: () => zod.z
 });
 exports.defineRouteSchema = defineRouteSchema;
+exports.sprint = sprint;

package/dist/esm/index.js

@@ -414,6 +414,7 @@ class Sprint {
           }
         }
       };
+      let allParams = [];
       if (route.schema?.body && !["GET", "HEAD", "DELETE"].includes(route.method)) {
         try {
           const bodySchema = this.zodSchemaToOpenAPI(route.schema.body);
@@ -433,11 +434,81 @@ class Sprint {
       if (route.schema?.queryParams) {
         try {
           const params = this.zodParamsToOpenAPI(route.schema.queryParams);
-          if (params.length > 0) routeSpec.parameters = params;
+          if (params.length > 0) allParams.push(...params);
         } catch (e) {
           console.warn("[Sprint] Failed to convert query params schema:", e);
         }
       }
+      if (route.schema?.headers) {
+        try {
+          const headers = this.zodHeadersToOpenAPI(route.schema.headers);
+          if (headers.length > 0) allParams.push(...headers);
+        } catch (e) {
+          console.warn("[Sprint] Failed to convert headers schema:", e);
+        }
+      }
+      if (this.openapi.generateOnBuild) {
+        try {
+          const routeMiddlewares = this.getMiddlewaresForRoute(route.path);
+          for (const mw of this.loadedMiddlewares) {
+            const includePatterns = Array.isArray(mw.include) ? mw.include : [mw.include || "/**"];
+            const excludePatterns = Array.isArray(mw.exclude) ? mw.exclude : mw.exclude ? [mw.exclude] : [];
+            const isIncluded = matchesPatterns(includePatterns, route.path);
+            const isExcluded = excludePatterns.length > 0 && matchesPatterns(excludePatterns, route.path);
+            if (isIncluded && !isExcluded && mw.__sprintMiddlewareSchema) {
+              const mwSchema = mw.__sprintMiddlewareSchema;
+              if (mwSchema.queryParams) {
+                const params = this.zodParamsToOpenAPI(mwSchema.queryParams);
+                if (params.length > 0) allParams.push(...params);
+              }
+              if (mwSchema.headers) {
+                const headers = this.zodHeadersToOpenAPI(mwSchema.headers);
+                if (headers.length > 0) allParams.push(...headers);
+              }
+              if (mwSchema.sprint?.authorization) {
+                const authSchema = mwSchema.sprint.authorization;
+                const description = authSchema._def?.description;
+                let sources = ["query:token", "headers:authorization"];
+                if (description) {
+                  try {
+                    const parsed = JSON.parse(description);
+                    if (parsed.__sprintAuthorization && parsed.sources) {
+                      sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+                    }
+                  } catch {
+                  }
+                }
+                for (const source of sources) {
+                  const [type, key] = source.split(":");
+                  if (type === "query") {
+                    allParams.push({
+                      name: key,
+                      in: "query",
+                      required: true,
+                      schema: { type: "string" }
+                    });
+                  } else if (type === "headers") {
+                    allParams.push({
+                      name: key,
+                      in: "header",
+                      required: true,
+                      schema: { type: "string" }
+                    });
+                  }
+                }
+              }
+            }
+          }
+        } catch (e) {
+          console.warn("[Sprint] Failed to add middleware schemas to OpenAPI:", e);
+        }
+      }
+      if (allParams.length > 0) {
+        const uniqueParams = allParams.filter(
+          (param, index, self) => index === self.findIndex((p) => p.name === param.name && p.in === param.in)
+        );
+        routeSpec.parameters = uniqueParams;
+      }
       paths[route.path][method] = routeSpec;
     }
     return {
@@ -511,6 +582,33 @@ class Sprint {
     }
     return params;
   }
+  zodHeadersToOpenAPI(schema) {
+    if (!schema) return [];
+    const headers = [];
+    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" };
+      }
+      headers.push({
+        name: key,
+        in: "header",
+        required: !zodDef?.isOptional,
+        schema: paramSchema
+      });
+    }
+    return headers;
+  }
   // HTTP Methods (prefix is applied automatically).
   get(path2, handler) {
     return this.app.get(this.applyPrefix(path2), handler);
@@ -587,6 +685,88 @@ class Sprint {
     });
   }
 }
+function createSchemaValidationMiddleware(schema) {
+  return (req, res, next) => {
+    const errors = [];
+    if (schema.body) {
+      const result = schema.body.safeParse(req.body);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "body",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.queryParams) {
+      const result = schema.queryParams.safeParse(req.query);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "queryParams",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.params) {
+      const result = schema.params.safeParse(req.params);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "params",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.headers) {
+      const result = schema.headers.safeParse(req.headers);
+      if (!result.success) {
+        errors.push(...result.error.issues.map((issue) => ({
+          location: "headers",
+          path: issue.path.join("."),
+          message: issue.message
+        })));
+      }
+    }
+    if (schema.sprint?.authorization) {
+      const authSchema = schema.sprint.authorization;
+      const description = authSchema._def?.description;
+      let sources = ["query:token", "headers:authorization"];
+      if (description) {
+        try {
+          const parsed = JSON.parse(description);
+          if (parsed.__sprintAuthorization && parsed.sources) sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+        } catch {
+        }
+      }
+      let authValue;
+      for (const source of sources) {
+        const [type, key] = source.split(":");
+        if (type === "query") {
+          const value = req.query[key];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+        } else if (type === "headers") {
+          const value = req.headers[key.toLowerCase()];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+          if (Array.isArray(value) && value.length > 0 && typeof value[0] === "string" && value[0].length > 0) {
+            authValue = value[0];
+            break;
+          }
+        }
+      }
+      if (!authValue) errors.push({ location: "sprint.authorization", path: "authorization", message: "Authorization header or query parameter not found" });
+      else req.sprint.authorization = authValue;
+    }
+    if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
+    next();
+  };
+}
 function defineMiddleware(config) {
   const wrapHandler = (handler) => {
     return (req, res, next) => {
@@ -594,10 +774,24 @@ function defineMiddleware(config) {
       if (result instanceof Promise) result.catch(next);
     };
   };
-  return {
+  const handlers = [];
+  if (config.schema) {
+    handlers.push(createSchemaValidationMiddleware(config.schema));
+  }
+  const originalHandler = config.handler;
+  if (Array.isArray(originalHandler)) {
+    handlers.push(...originalHandler.map(wrapHandler));
+  } else {
+    handlers.push(wrapHandler(originalHandler));
+  }
+  const finalConfig = {
     ...config,
-    handler: Array.isArray(config.handler) ? config.handler.map(wrapHandler) : wrapHandler(config.handler)
+    handler: handlers
   };
+  if (config.schema) {
+    finalConfig.__sprintMiddlewareSchema = config.schema;
+  }
+  return finalConfig;
 }
 const Router = () => Router$1();
 export {

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

@@ -1,4 +1,15 @@
 import { z } from "zod";
+import { z as z2 } from "zod";
+function createSprintAuthorizationSchema(options) {
+  const defaultSources = ["query:token", "headers:authorization"];
+  const sources = options?.sources ? Array.isArray(options.sources) ? options.sources : [options.sources] : defaultSources;
+  return z.string().describe(JSON.stringify({ __sprintAuthorization: true, sources }));
+}
+const sprintBuilder = {
+  authorization: createSprintAuthorizationSchema
+};
+z.sprint = sprintBuilder;
+const sprint = sprintBuilder;
 function parseSchema(schema, data) {
   const result = schema.safeParse(data);
   if (!result.success) {
@@ -27,6 +38,47 @@ function defineRouteSchema(schema) {
       const result = parseSchema(schema.params, req.params);
       if (!result.success) errors.push(...result.errors.map((e) => ({ location: "params", ...e })));
     }
+    if (schema.headers) {
+      const result = parseSchema(schema.headers, req.headers);
+      if (!result.success) errors.push(...result.errors.map((e) => ({ location: "headers", ...e })));
+    }
+    if (schema.sprint?.authorization) {
+      const authSchema = schema.sprint.authorization;
+      const description = authSchema._def?.description;
+      let sources = ["query:token", "headers:authorization"];
+      if (description) {
+        try {
+          const parsed = JSON.parse(description);
+          if (parsed.__sprintAuthorization && parsed.sources) {
+            sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
+          }
+        } catch {
+        }
+      }
+      let authValue;
+      for (const source of sources) {
+        const [type, key] = source.split(":");
+        if (type === "query") {
+          const value = req.query[key];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+        } else if (type === "headers") {
+          const value = req.headers[key.toLowerCase()];
+          if (typeof value === "string" && value.length > 0) {
+            authValue = value;
+            break;
+          }
+          if (Array.isArray(value) && value.length > 0 && typeof value[0] === "string" && value[0].length > 0) {
+            authValue = value[0];
+            break;
+          }
+        }
+      }
+      if (!authValue) errors.push({ location: "sprint.authorization", path: "authorization", message: "Authorization header or query parameter not found" });
+      else req.sprint.authorization = authValue;
+    }
     if (errors.length > 0) return res.status(400).json({ error: "Validation failed", details: errors });
     next();
   };
@@ -35,5 +87,6 @@ function defineRouteSchema(schema) {
 }
 export {
   defineRouteSchema,
-  z
+  sprint,
+  z2 as z
 };

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

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAY3E"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAyC,MAAM,SAAS,CAAC;AA6FlF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CA+B3E"}

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

@@ -1,10 +1,22 @@
 import { RequestHandler } from 'express';
 import { z, ZodSchema as ZodSchemaType, ZodTypeDef } from 'zod';
 export { z };
+export type AuthorizationSource = `query:${string}` | `headers:${string}`;
+export interface SprintAuthorizationOptions {
+    sources?: AuthorizationSource | AuthorizationSource[];
+}
+declare function createSprintAuthorizationSchema(options?: SprintAuthorizationOptions): ZodSchemaType<string, ZodTypeDef, string>;
+export declare const sprint: {
+    authorization: typeof createSprintAuthorizationSchema;
+};
 export interface RouteSchemaOptions {
     body?: ZodSchemaType<any, ZodTypeDef, any>;
     queryParams?: ZodSchemaType<any, ZodTypeDef, any>;
     params?: ZodSchemaType<any, ZodTypeDef, any>;
+    headers?: ZodSchemaType<any, ZodTypeDef, any>;
+    sprint?: {
+        authorization?: ZodSchemaType<string, ZodTypeDef, string>;
+    };
 }
 export declare function defineRouteSchema<T extends RouteSchemaOptions>(schema: T): RequestHandler;
 export type { ZodSchema, ZodMiddlewareOptions } from './types';

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,CA4BzF;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,EAAuB,MAAM,KAAK,CAAC;AAErF,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,MAAM,MAAM,mBAAmB,GAAG,SAAS,MAAM,EAAE,GAAG,WAAW,MAAM,EAAE,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACvC,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;CACzD;AAED,iBAAS,+BAA+B,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAKxH;AAQD,eAAO,MAAM,MAAM;;CAAgB,CAAC;AAEpC,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;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;KAC7D,CAAC;CACL;AAqBD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,cAAc,CAyEzF;AAED,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -4,5 +4,9 @@ export interface ZodMiddlewareOptions {
     body?: ZodSchema;
     queryParams?: ZodSchema;
     params?: ZodSchema;
+    headers?: ZodSchema;
+    sprint?: {
+        authorization?: ZodSchema;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,SAAS,CAAC;KAC7B,CAAC;CACL"}

package/dist/types/sprint.d.ts

@@ -36,6 +36,7 @@ export declare class Sprint {
     private generateOpenAPISpec;
     private zodSchemaToOpenAPI;
     private zodParamsToOpenAPI;
+    private zodHeadersToOpenAPI;
     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;;YA2EM,IAAI;IA8BlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YAkFV,YAAY;IAmB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA0D3B,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"}
+{"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;;YA2EM,IAAI;IA8BlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAgC7B,OAAO,CAAC,eAAe;YAcT,UAAU;YAkFV,YAAY;IAmB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA8I3B,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,mBAAmB;IAoCpB,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/dist/types/types.d.ts

@@ -1,9 +1,11 @@
 import { Request, Response, NextFunction, RequestHandler } from 'express';
+import { ZodSchema } from './modules/schemas/types';
 export type AsyncRequestHandler = (req: Request, res: Response, next: NextFunction) => Promise<any>;
 export type Handler = (req: Request, res: Response, next: NextFunction) => any;
 export type AuthorizationSource = `query:${string}` | `headers:${string}`;
 export interface SprintRequest {
     getAuthorization: (sources?: AuthorizationSource | AuthorizationSource[]) => string | undefined;
+    authorization?: string;
 }
 export type SprintResponse = Response;
 declare global {
@@ -14,6 +16,15 @@ declare global {
         }
     }
 }
+export interface MiddlewareSchema {
+    body?: ZodSchema;
+    queryParams?: ZodSchema;
+    params?: ZodSchema;
+    headers?: ZodSchema;
+    sprint?: {
+        authorization?: ZodSchema;
+    };
+}
 /**
  * Configuration for a middleware defined in the middlewares folder.
  * Export this from your middleware file using `defineMiddleware()`.
@@ -43,6 +54,11 @@ export interface MiddlewareConfig {
     priority?: number;
     /** Optional name for logging purposes */
     name?: string;
+    /**
+     * Schema for request validation and OpenAPI generation.
+     * Supports body, queryParams, params, headers, and sprint.authorization.
+     */
+    schema?: MiddlewareSchema;
 }
 export interface LoadedMiddleware extends MiddlewareConfig {
     name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"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.74",
+    "version": "0.0.76",
     "description": "Sprint - Quickly API",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",