@engjts/nexus 0.1.0

package/dist/advanced/static/serveStatic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveStatic.d.ts","sourceRoot":"","sources":["../../../src/advanced/static/serveStatic.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AAEH,wBAAgB,WAAW,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CAmN7D"}

package/dist/advanced/static/serveStatic.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveStatic = serveStatic;
+const fs_1 = require("fs");
+const posix_1 = require("path/posix");
+const generateDirectoryListing_1 = require("./generateDirectoryListing");
+const isSafePath_1 = require("./isSafePath");
+const generateETag_1 = require("./generateETag");
+const getMimeType_1 = require("./getMimeType");
+/**
+ * Create static file serving feature
+ */
+function serveStatic(config = {}) {
+    const { root = './public', prefix = '', index = 'index.html', directory = false, maxAge = 86400, immutable = false, etag = true, lastModified = true, extensions, dotfiles = 'ignore', fallback, headers = {}, precompressed = false } = config;
+    const rootPath = (0, posix_1.resolve)(process.cwd(), root);
+    const normalizedPrefix = prefix.startsWith('/') ? prefix : prefix ? `/${prefix}` : '';
+    return {
+        name: 'static',
+        version: '1.0.0',
+        install(app) {
+            // Create the static file handler
+            const staticHandler = async (ctx) => {
+                let requestPath = ctx.path;
+                // Remove prefix if set
+                if (normalizedPrefix && requestPath.startsWith(normalizedPrefix)) {
+                    requestPath = requestPath.slice(normalizedPrefix.length) || '/';
+                }
+                else if (normalizedPrefix) {
+                    // Path doesn't match prefix, skip
+                    return { statusCode: 404, headers: {}, body: 'Not Found' };
+                }
+                // Decode URL
+                try {
+                    requestPath = decodeURIComponent(requestPath);
+                }
+                catch {
+                    return { statusCode: 400, headers: {}, body: 'Bad Request' };
+                }
+                // Remove leading slash for joining
+                const cleanPath = requestPath.startsWith('/') ? requestPath.slice(1) : requestPath;
+                // Security: Check for directory traversal
+                if (!(0, isSafePath_1.isSafePath)(cleanPath, rootPath)) {
+                    return { statusCode: 403, headers: {}, body: 'Forbidden' };
+                }
+                const filePath = (0, posix_1.join)(rootPath, cleanPath);
+                // Handle dotfiles
+                const basename = cleanPath.split('/').pop() || '';
+                if (basename.startsWith('.')) {
+                    if (dotfiles === 'deny') {
+                        return { statusCode: 403, headers: {}, body: 'Forbidden' };
+                    }
+                    if (dotfiles === 'ignore') {
+                        return { statusCode: 404, headers: {}, body: 'Not Found' };
+                    }
+                }
+                // Check if file/directory exists
+                if (!(0, fs_1.existsSync)(filePath)) {
+                    // Try fallback for SPA
+                    if (fallback) {
+                        const fallbackPath = (0, posix_1.join)(rootPath, fallback);
+                        if ((0, fs_1.existsSync)(fallbackPath)) {
+                            return serveFile(fallbackPath, ctx);
+                        }
+                    }
+                    return { statusCode: 404, headers: {}, body: 'Not Found' };
+                }
+                const stats = (0, fs_1.statSync)(filePath);
+                // Handle directory
+                if (stats.isDirectory()) {
+                    // Try index file(s)
+                    if (index !== false) {
+                        const indexFiles = Array.isArray(index) ? index : [index];
+                        for (const indexFile of indexFiles) {
+                            const indexPath = (0, posix_1.join)(filePath, indexFile);
+                            if ((0, fs_1.existsSync)(indexPath)) {
+                                return serveFile(indexPath, ctx);
+                            }
+                        }
+                    }
+                    // Directory listing
+                    if (directory) {
+                        const html = await (0, generateDirectoryListing_1.generateDirectoryListing)(filePath, requestPath);
+                        return {
+                            statusCode: 200,
+                            headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                            body: html
+                        };
+                    }
+                    return { statusCode: 404, headers: {}, body: 'Not Found' };
+                }
+                // Check extension whitelist
+                const ext = (0, posix_1.extname)(filePath);
+                if (extensions && !extensions.includes(ext)) {
+                    return { statusCode: 403, headers: {}, body: 'Forbidden' };
+                }
+                return serveFile(filePath, ctx);
+            };
+            // Helper to serve a file
+            async function serveFile(filePath, ctx) {
+                const stats = (0, fs_1.statSync)(filePath);
+                const ext = (0, posix_1.extname)(filePath);
+                const mimeType = (0, getMimeType_1.getMimeType)(ext);
+                const responseHeaders = {
+                    'Content-Type': mimeType,
+                    'Content-Length': stats.size.toString(),
+                    ...headers
+                };
+                // Cache headers
+                let cacheControl = `public, max-age=${maxAge}`;
+                if (immutable) {
+                    cacheControl += ', immutable';
+                }
+                responseHeaders['Cache-Control'] = cacheControl;
+                // ETag
+                if (etag) {
+                    const etagValue = (0, generateETag_1.generateETag)(stats);
+                    responseHeaders['ETag'] = etagValue;
+                    // Check If-None-Match
+                    const ifNoneMatch = ctx.headers['if-none-match'];
+                    if (ifNoneMatch === etagValue) {
+                        return { statusCode: 304, headers: responseHeaders, body: '' };
+                    }
+                }
+                // Last-Modified
+                if (lastModified) {
+                    const lastMod = stats.mtime.toUTCString();
+                    responseHeaders['Last-Modified'] = lastMod;
+                    // Check If-Modified-Since
+                    const ifModifiedSince = ctx.headers['if-modified-since'];
+                    if (ifModifiedSince) {
+                        const ifModDate = new Date(ifModifiedSince);
+                        if (stats.mtime <= ifModDate) {
+                            return { statusCode: 304, headers: responseHeaders, body: '' };
+                        }
+                    }
+                }
+                // Check for pre-compressed version
+                if (precompressed) {
+                    const acceptEncoding = ctx.headers['accept-encoding'] || '';
+                    const compressions = Array.isArray(precompressed)
+                        ? precompressed
+                        : ['br', 'gzip'];
+                    for (const encoding of compressions) {
+                        if (acceptEncoding.includes(encoding)) {
+                            const ext = encoding === 'br' ? '.br' : '.gz';
+                            const compressedPath = filePath + ext;
+                            if ((0, fs_1.existsSync)(compressedPath)) {
+                                const compressedStats = (0, fs_1.statSync)(compressedPath);
+                                responseHeaders['Content-Encoding'] = encoding;
+                                responseHeaders['Content-Length'] = compressedStats.size.toString();
+                                responseHeaders['Vary'] = 'Accept-Encoding';
+                                return {
+                                    statusCode: 200,
+                                    headers: responseHeaders,
+                                    body: '',
+                                    stream: (0, fs_1.createReadStream)(compressedPath)
+                                };
+                            }
+                        }
+                    }
+                }
+                // Stream the file
+                return {
+                    statusCode: 200,
+                    headers: responseHeaders,
+                    body: '',
+                    stream: (0, fs_1.createReadStream)(filePath)
+                };
+            }
+            // Register static file handler
+            if (normalizedPrefix) {
+                // With prefix: only serve files under that prefix as routes
+                app.get(`${normalizedPrefix}`, staticHandler);
+                app.get(`${normalizedPrefix}/*`, staticHandler);
+            }
+            else {
+                // Without prefix: register as fallback handler
+                // This is called when no routes match, before 404
+                if (typeof app.setFallbackHandler === 'function') {
+                    app.setFallbackHandler(staticHandler);
+                }
+                else {
+                    // Fallback: register as low-priority wildcard routes
+                    // NOTE: This should be registered LAST after all API routes
+                    app.get('/', staticHandler);
+                    app.get('/*', staticHandler);
+                }
+            }
+            if (app.config?.debug) {
+                console.log(`📁 Static files: ${rootPath}`);
+                if (normalizedPrefix) {
+                    console.log(`   Prefix: ${normalizedPrefix}`);
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=serveStatic.js.map

package/dist/advanced/static/serveStatic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveStatic.js","sourceRoot":"","sources":["../../../src/advanced/static/serveStatic.ts"],"names":[],"mappings":";;AAaA,kCAmNC;AAhOD,2BAA4D;AAC5D,sCAAoD;AACpD,yEAAsE;AACtE,6CAA0C;AAC1C,iDAA8C;AAC9C,+CAA4C;AAI5C;;GAEG;AAEH,SAAgB,WAAW,CAAC,SAAuB,EAAE;IACjD,MAAM,EACF,IAAI,GAAG,UAAU,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,YAAY,EAAE,SAAS,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,UAAU,EAAE,QAAQ,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAE,aAAa,GAAG,KAAK,EAC/N,GAAG,MAAM,CAAC;IAEX,MAAM,QAAQ,GAAG,IAAA,eAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,OAAO;QACH,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;QAEhB,OAAO,CAAC,GAAQ;YACZ,iCAAiC;YACjC,MAAM,aAAa,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;gBACzC,IAAI,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;gBAE3B,uBAAuB;gBACvB,IAAI,gBAAgB,IAAI,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBAC/D,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;gBACpE,CAAC;qBAAM,IAAI,gBAAgB,EAAE,CAAC;oBAC1B,kCAAkC;oBAClC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC/D,CAAC;gBAED,aAAa;gBACb,IAAI,CAAC;oBACD,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACL,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;gBACjE,CAAC;gBAED,mCAAmC;gBACnC,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAEnF,0CAA0C;gBAC1C,IAAI,CAAC,IAAA,uBAAU,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACnC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC/D,CAAC;gBAED,MAAM,QAAQ,GAAG,IAAA,YAAI,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBAE3C,kBAAkB;gBAClB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAClD,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC3B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;wBACtB,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;oBAC/D,CAAC;oBACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBACxB,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;oBAC/D,CAAC;gBACL,CAAC;gBAED,iCAAiC;gBACjC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,uBAAuB;oBACvB,IAAI,QAAQ,EAAE,CAAC;wBACX,MAAM,YAAY,GAAG,IAAA,YAAI,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;wBAC9C,IAAI,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;4BAC3B,OAAO,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;wBACxC,CAAC;oBACL,CAAC;oBACD,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC/D,CAAC;gBAED,MAAM,KAAK,GAAG,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC;gBAEjC,mBAAmB;gBACnB,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACtB,oBAAoB;oBACpB,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;wBAClB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBAC1D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;4BACjC,MAAM,SAAS,GAAG,IAAA,YAAI,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;4BAC5C,IAAI,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;gCACxB,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;4BACrC,CAAC;wBACL,CAAC;oBACL,CAAC;oBAED,oBAAoB;oBACpB,IAAI,SAAS,EAAE,CAAC;wBACZ,MAAM,IAAI,GAAG,MAAM,IAAA,mDAAwB,EAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;wBACnE,OAAO;4BACH,UAAU,EAAE,GAAG;4BACf,OAAO,EAAE,EAAE,cAAc,EAAE,0BAA0B,EAAE;4BACvD,IAAI,EAAE,IAAI;yBACb,CAAC;oBACN,CAAC;oBAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC/D,CAAC;gBAED,4BAA4B;gBAC5B,MAAM,GAAG,GAAG,IAAA,eAAO,EAAC,QAAQ,CAAC,CAAC;gBAC9B,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC/D,CAAC;gBAED,OAAO,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACpC,CAAC,CAAC;YAEF,yBAAyB;YACzB,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAQ;gBAC/C,MAAM,KAAK,GAAG,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,GAAG,GAAG,IAAA,eAAO,EAAC,QAAQ,CAAC,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAA,yBAAW,EAAC,GAAG,CAAC,CAAC;gBAElC,MAAM,eAAe,GAA2B;oBAC5C,cAAc,EAAE,QAAQ;oBACxB,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;oBACvC,GAAG,OAAO;iBACb,CAAC;gBAEF,gBAAgB;gBAChB,IAAI,YAAY,GAAG,mBAAmB,MAAM,EAAE,CAAC;gBAC/C,IAAI,SAAS,EAAE,CAAC;oBACZ,YAAY,IAAI,aAAa,CAAC;gBAClC,CAAC;gBACD,eAAe,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;gBAEhD,OAAO;gBACP,IAAI,IAAI,EAAE,CAAC;oBACP,MAAM,SAAS,GAAG,IAAA,2BAAY,EAAC,KAAK,CAAC,CAAC;oBACtC,eAAe,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;oBAEpC,sBAAsB;oBACtB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;oBACjD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;wBAC5B,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;oBACnE,CAAC;gBACL,CAAC;gBAED,gBAAgB;gBAChB,IAAI,YAAY,EAAE,CAAC;oBACf,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC1C,eAAe,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC;oBAE3C,0BAA0B;oBAC1B,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;oBACzD,IAAI,eAAe,EAAE,CAAC;wBAClB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC;wBAC5C,IAAI,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;4BAC3B,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;wBACnE,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,mCAAmC;gBACnC,IAAI,aAAa,EAAE,CAAC;oBAChB,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;oBAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;wBAC7C,CAAC,CAAC,aAAa;wBACf,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAErB,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;wBAClC,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;4BACpC,MAAM,GAAG,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;4BAC9C,MAAM,cAAc,GAAG,QAAQ,GAAG,GAAG,CAAC;4BACtC,IAAI,IAAA,eAAU,EAAC,cAAc,CAAC,EAAE,CAAC;gCAC7B,MAAM,eAAe,GAAG,IAAA,aAAQ,EAAC,cAAc,CAAC,CAAC;gCACjD,eAAe,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC;gCAC/C,eAAe,CAAC,gBAAgB,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gCACpE,eAAe,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC;gCAE5C,OAAO;oCACH,UAAU,EAAE,GAAG;oCACf,OAAO,EAAE,eAAe;oCACxB,IAAI,EAAE,EAAE;oCACR,MAAM,EAAE,IAAA,qBAAgB,EAAC,cAAc,CAAC;iCAC3C,CAAC;4BACN,CAAC;wBACL,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,kBAAkB;gBAClB,OAAO;oBACH,UAAU,EAAE,GAAG;oBACf,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,IAAA,qBAAgB,EAAC,QAAQ,CAAC;iBACrC,CAAC;YACN,CAAC;YAED,+BAA+B;YAC/B,IAAI,gBAAgB,EAAE,CAAC;gBACnB,4DAA4D;gBAC5D,GAAG,CAAC,GAAG,CAAC,GAAG,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC;gBAC9C,GAAG,CAAC,GAAG,CAAC,GAAG,gBAAgB,IAAI,EAAE,aAAa,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACJ,+CAA+C;gBAC/C,kDAAkD;gBAClD,IAAI,OAAO,GAAG,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC;oBAC/C,GAAG,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACJ,qDAAqD;oBACrD,4DAA4D;oBAC5D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;oBAC5B,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;gBACjC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;gBAC5C,IAAI,gBAAgB,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,cAAc,gBAAgB,EAAE,CAAC,CAAC;gBAClD,CAAC;YACL,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/advanced/static/spa.d.ts

@@ -0,0 +1,14 @@
+import { Plugin } from '../../core/types';
+/**
+ * Create SPA (Single Page Application) static serving
+ * Falls back to index.html for client-side routing
+ *
+ * @example
+ * ```typescript
+ * app.feature(spa());           // SPA from ./public
+ * app.feature(spa('./dist'));   // SPA from ./dist
+ * ```
+ */
+export declare function spa(root?: string): Plugin;
+export type { Plugin };
+//# sourceMappingURL=spa.d.ts.map

package/dist/advanced/static/spa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.d.ts","sourceRoot":"","sources":["../../../src/advanced/static/spa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C;;;;;;;;;GASG;AAEH,wBAAgB,GAAG,CAAC,IAAI,SAAa,GAAG,MAAM,CAO7C;AAED,YAAY,EAAE,MAAM,EAAE,CAAC"}

package/dist/advanced/static/spa.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spa = spa;
+const serveStatic_1 = require("./serveStatic");
+/**
+ * Create SPA (Single Page Application) static serving
+ * Falls back to index.html for client-side routing
+ *
+ * @example
+ * ```typescript
+ * app.feature(spa());           // SPA from ./public
+ * app.feature(spa('./dist'));   // SPA from ./dist
+ * ```
+ */
+function spa(root = './public') {
+    return (0, serveStatic_1.serveStatic)({
+        root,
+        fallback: 'index.html',
+        maxAge: 0, // No cache for HTML
+        etag: true
+    });
+}
+//# sourceMappingURL=spa.js.map

package/dist/advanced/static/spa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.js","sourceRoot":"","sources":["../../../src/advanced/static/spa.ts"],"names":[],"mappings":";;AAcA,kBAOC;AApBD,+CAA4C;AAE5C;;;;;;;;;GASG;AAEH,SAAgB,GAAG,CAAC,IAAI,GAAG,UAAU;IACjC,OAAO,IAAA,yBAAW,EAAC;QACf,IAAI;QACJ,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,CAAC,EAAE,oBAAoB;QAC/B,IAAI,EAAE,IAAI;KACb,CAAC,CAAC;AACP,CAAC"}

package/dist/advanced/static/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MIME types mapping
+ */
+export declare const MIME_TYPES: Record<string, string>;
+/**
+ * Static file serving configuration
+ */
+export interface StaticConfig {
+    /**
+     * Root directory to serve files from
+     * @default './public'
+     */
+    root?: string;
+    /**
+     * URL prefix for static files
+     * @default '' (serve from root)
+     * @example '/static' → /static/image.png serves ./public/image.png
+     */
+    prefix?: string;
+    /**
+     * Default file to serve for directory requests
+     * @default 'index.html'
+     */
+    index?: string | string[] | false;
+    /**
+     * Enable directory listing
+     * @default false
+     */
+    directory?: boolean;
+    /**
+     * Maximum age for Cache-Control header (in seconds)
+     * @default 86400 (1 day)
+     */
+    maxAge?: number;
+    /**
+     * Enable immutable caching (for versioned assets)
+     * @default false
+     */
+    immutable?: boolean;
+    /**
+     * Enable ETag generation
+     * @default true
+     */
+    etag?: boolean;
+    /**
+     * Enable Last-Modified header
+     * @default true
+     */
+    lastModified?: boolean;
+    /**
+     * Allowed file extensions (whitelist)
+     * @default undefined (allow all)
+     * @example ['.html', '.css', '.js', '.png']
+     */
+    extensions?: string[];
+    /**
+     * Hidden files (dotfiles) handling
+     * @default 'ignore'
+     */
+    dotfiles?: 'allow' | 'deny' | 'ignore';
+    /**
+     * Fallback file for SPA routing
+     * @default undefined
+     * @example 'index.html' for SPA
+     */
+    fallback?: string;
+    /**
+     * Custom headers to add to responses
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable gzip/brotli pre-compressed files
+     * Looks for .gz or .br versions of files
+     * @default false
+     */
+    precompressed?: boolean | ('gzip' | 'br')[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/advanced/static/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmE7C,CAAC;AAGF;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/C"}

package/dist/advanced/static/types.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * MIME types mapping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIME_TYPES = void 0;
+exports.MIME_TYPES = {
+    // Text
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.xml': 'application/xml; charset=utf-8',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.csv': 'text/csv; charset=utf-8',
+    // Images
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.bmp': 'image/bmp',
+    '.avif': 'image/avif',
+    // Fonts
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.eot': 'application/vnd.ms-fontobject',
+    // Audio
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.m4a': 'audio/mp4',
+    '.flac': 'audio/flac',
+    // Video
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.avi': 'video/x-msvideo',
+    '.mov': 'video/quicktime',
+    '.mkv': 'video/x-matroska',
+    // Documents
+    '.pdf': 'application/pdf',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    // Archives
+    '.zip': 'application/zip',
+    '.rar': 'application/vnd.rar',
+    '.7z': 'application/x-7z-compressed',
+    '.tar': 'application/x-tar',
+    '.gz': 'application/gzip',
+    // Data
+    '.wasm': 'application/wasm',
+    '.map': 'application/json',
+    // Default
+    '': 'application/octet-stream'
+};
+//# sourceMappingURL=types.js.map

package/dist/advanced/static/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/advanced/static/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,UAAU,GAA2B;IAC9C,OAAO;IACP,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,8BAA8B;IACrC,MAAM,EAAE,yBAAyB;IAEjC,SAAS;IACT,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IAErB,QAAQ;IACR,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,+BAA+B;IAEvC,QAAQ;IACR,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IAErB,QAAQ;IACR,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,kBAAkB;IAE1B,YAAY;IACZ,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,oBAAoB;IAC5B,OAAO,EAAE,yEAAyE;IAClF,MAAM,EAAE,0BAA0B;IAClC,OAAO,EAAE,mEAAmE;IAC5E,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,2EAA2E;IAEpF,WAAW;IACX,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,qBAAqB;IAC7B,KAAK,EAAE,6BAA6B;IACpC,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,kBAAkB;IAEzB,OAAO;IACP,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,kBAAkB;IAE1B,UAAU;IACV,EAAE,EAAE,0BAA0B;CACjC,CAAC"}

package/dist/advanced/swagger/SwaggerGenerator.d.ts

@@ -0,0 +1,19 @@
+import { RouteConfig } from '../../core/types';
+import { SwaggerConfig, OpenAPISchema, OpenAPISpec } from './types';
+/**
+ * SwaggerGenerator class for advanced/manual usage
+ * @deprecated Use swagger() plugin instead
+ */
+export declare class SwaggerGenerator {
+    private config;
+    private routes;
+    private schemas;
+    constructor(config?: SwaggerConfig);
+    registerRoutes(routes: RouteConfig[]): void;
+    registerRoute(route: RouteConfig): void;
+    registerSchema(name: string, schema: OpenAPISchema): void;
+    generateSpec(): OpenAPISpec;
+    generateSwaggerUI(): string;
+    getConfig(): SwaggerConfig;
+}
+//# sourceMappingURL=SwaggerGenerator.d.ts.map

package/dist/advanced/swagger/SwaggerGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerGenerator.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/SwaggerGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAe,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKjF;;;GAGG;AAGH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAyC;gBAE5C,MAAM,GAAE,aAAkB;IAatC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAS3C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IASvC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAIzD,YAAY,IAAI,WAAW;IAI3B,iBAAiB,IAAI,MAAM;IAI3B,SAAS,IAAI,aAAa;CAG3B"}

package/dist/advanced/swagger/SwaggerGenerator.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerGenerator = void 0;
+const generateSpec_1 = require("./generateSpec");
+const generateSwaggerUI_1 = require("./generateSwaggerUI");
+// ============================================
+// LEGACY EXPORTS (backward compatibility)
+// ============================================
+/**
+ * SwaggerGenerator class for advanced/manual usage
+ * @deprecated Use swagger() plugin instead
+ */
+class SwaggerGenerator {
+    config;
+    routes = [];
+    schemas = new Map();
+    constructor(config = {}) {
+        this.config = {
+            path: '/docs',
+            specPath: '/openapi.json',
+            ...config,
+            info: {
+                title: 'API Documentation',
+                version: '1.0.0',
+                ...config.info
+            }
+        };
+    }
+    registerRoutes(routes) {
+        this.routes.push(...routes.map(r => ({
+            method: r.method,
+            path: r.path,
+            schema: r.schema,
+            meta: r.meta
+        })));
+    }
+    registerRoute(route) {
+        this.routes.push({
+            method: route.method,
+            path: route.path,
+            schema: route.schema,
+            meta: route.meta
+        });
+    }
+    registerSchema(name, schema) {
+        this.schemas.set(name, schema);
+    }
+    generateSpec() {
+        return (0, generateSpec_1.generateSpec)(this.routes, this.schemas, this.config, '');
+    }
+    generateSwaggerUI() {
+        return (0, generateSwaggerUI_1.generateSwaggerUI)(this.config);
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+exports.SwaggerGenerator = SwaggerGenerator;
+//# sourceMappingURL=SwaggerGenerator.js.map

package/dist/advanced/swagger/SwaggerGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerGenerator.js","sourceRoot":"","sources":["../../../src/advanced/swagger/SwaggerGenerator.ts"],"names":[],"mappings":";;;AACA,iDAA8C;AAC9C,2DAAwD;AAGxD,+CAA+C;AAC/C,0CAA0C;AAC1C,+CAA+C;AAC/C;;;GAGG;AAGH,MAAa,gBAAgB;IACnB,MAAM,CAAgB;IACtB,MAAM,GAAkB,EAAE,CAAC;IAC3B,OAAO,GAA+B,IAAI,GAAG,EAAE,CAAC;IAExD,YAAY,SAAwB,EAAE;QACpC,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,eAAe;YACzB,GAAG,MAAM;YACT,IAAI,EAAE;gBACJ,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,OAAO;gBAChB,GAAG,MAAM,CAAC,IAAI;aACf;SACF,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,MAAqB;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnC,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,aAAa,CAAC,KAAkB;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,MAAqB;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,YAAY;QACV,OAAO,IAAA,2BAAY,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,iBAAiB;QACf,OAAO,IAAA,qCAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnDD,4CAmDC"}

package/dist/advanced/swagger/buildOperation.d.ts

@@ -0,0 +1,6 @@
+import { StoredRoute, SwaggerConfig, OpenAPIOperation } from './types';
+/**
+ * Build OpenAPI operation from route
+ */
+export declare function buildOperation(route: StoredRoute, config: SwaggerConfig): OpenAPIOperation;
+//# sourceMappingURL=buildOperation.d.ts.map

package/dist/advanced/swagger/buildOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildOperation.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/buildOperation.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvE;;GAEG;AAGH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,gBAAgB,CA+C1F"}

package/dist/advanced/swagger/buildOperation.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOperation = buildOperation;
+const buildRequestBody_1 = require("./buildRequestBody");
+const buildParameters_1 = require("./buildParameters");
+const buildResponses_1 = require("./buildResponses");
+const capitalize_1 = require("./capitalize");
+const generateOperationId_1 = require("./generateOperationId");
+const generateSummary_1 = require("./generateSummary");
+/**
+ * Build OpenAPI operation from route
+ */
+function buildOperation(route, config) {
+    const meta = route.meta || {};
+    const operation = {
+        responses: (0, buildResponses_1.buildResponses)(meta.responses, route.method)
+    };
+    // Auto-generate summary from path if not provided
+    if (meta.summary) {
+        operation.summary = meta.summary;
+    }
+    else {
+        operation.summary = (0, generateSummary_1.generateSummary)(route.method, route.path);
+    }
+    if (meta.description) {
+        operation.description = meta.description;
+    }
+    if (meta.tags && meta.tags.length > 0) {
+        operation.tags = meta.tags;
+    }
+    else if (!config.hideUntagged) {
+        // Auto-tag based on first path segment
+        const firstSegment = route.path.split('/').filter(Boolean)[0];
+        if (firstSegment && !firstSegment.startsWith(':')) {
+            operation.tags = [(0, capitalize_1.capitalize)(firstSegment)];
+        }
+    }
+    if (meta.deprecated) {
+        operation.deprecated = true;
+    }
+    // Generate operation ID
+    operation.operationId = (0, generateOperationId_1.generateOperationId)(route.method, route.path);
+    // Build parameters from schema
+    const parameters = (0, buildParameters_1.buildParameters)(route);
+    if (parameters.length > 0) {
+        operation.parameters = parameters;
+    }
+    // Build request body for POST/PUT/PATCH
+    if (route.schema?.body && ['POST', 'PUT', 'PATCH'].includes(route.method)) {
+        operation.requestBody = (0, buildRequestBody_1.buildRequestBody)(route.schema);
+    }
+    return operation;
+}
+//# sourceMappingURL=buildOperation.js.map

package/dist/advanced/swagger/buildOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildOperation.js","sourceRoot":"","sources":["../../../src/advanced/swagger/buildOperation.ts"],"names":[],"mappings":";;AAaA,wCA+CC;AA5DD,yDAAsD;AACtD,uDAAoD;AACpD,qDAAkD;AAClD,6CAA0C;AAC1C,+DAA4D;AAC5D,uDAAoD;AAGpD;;GAEG;AAGH,SAAgB,cAAc,CAAC,KAAkB,EAAE,MAAqB;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAqB;QAClC,SAAS,EAAE,IAAA,+BAAc,EAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;KACxD,CAAC;IAEF,kDAAkD;IAClD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,OAAO,GAAG,IAAA,iCAAe,EAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC7B,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAChC,uCAAuC;QACvC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClD,SAAS,CAAC,IAAI,GAAG,CAAC,IAAA,uBAAU,EAAC,YAAY,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,wBAAwB;IACxB,SAAS,CAAC,WAAW,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtE,+BAA+B;IAC/B,MAAM,UAAU,GAAG,IAAA,iCAAe,EAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,UAAU,GAAG,UAAU,CAAC;IACpC,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,SAAS,CAAC,WAAW,GAAG,IAAA,mCAAgB,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/advanced/swagger/buildParameters.d.ts

@@ -0,0 +1,6 @@
+import { StoredRoute, OpenAPIParameter } from './types';
+/**
+ * Build parameters from route schema
+ */
+export declare function buildParameters(route: StoredRoute): OpenAPIParameter[];
+//# sourceMappingURL=buildParameters.d.ts.map

package/dist/advanced/swagger/buildParameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildParameters.d.ts","sourceRoot":"","sources":["../../../src/advanced/swagger/buildParameters.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAiB,MAAM,SAAS,CAAC;AAEvE;;GAEG;AAGH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,EAAE,CAkDtE"}

package/dist/advanced/swagger/buildParameters.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildParameters = buildParameters;
+const zodToOpenAPI_1 = require("./zodToOpenAPI");
+const zodSchemaToOpenAPI_1 = require("./zodSchemaToOpenAPI");
+const capitalize_1 = require("./capitalize");
+/**
+ * Build parameters from route schema
+ */
+function buildParameters(route) {
+    const parameters = [];
+    // Extract path parameters
+    const pathParams = route.path.match(/:(\w+)/g);
+    if (pathParams) {
+        for (const param of pathParams) {
+            const name = param.slice(1);
+            const schemaFromZod = (0, zodToOpenAPI_1.zodToOpenAPI)(route.schema?.params, name);
+            parameters.push({
+                name,
+                in: 'path',
+                required: true,
+                description: `${(0, capitalize_1.capitalize)(name)} parameter`,
+                schema: schemaFromZod || { type: 'string' }
+            });
+        }
+    }
+    // Add query parameters from schema
+    if (route.schema?.query) {
+        const querySchema = (0, zodSchemaToOpenAPI_1.zodSchemaToOpenAPI)(route.schema.query);
+        if (querySchema.properties) {
+            for (const [name, schema] of Object.entries(querySchema.properties)) {
+                parameters.push({
+                    name,
+                    in: 'query',
+                    required: querySchema.required?.includes(name) || false,
+                    schema: schema
+                });
+            }
+        }
+    }
+    // Add header parameters from schema
+    if (route.schema?.headers) {
+        const headerSchema = (0, zodSchemaToOpenAPI_1.zodSchemaToOpenAPI)(route.schema.headers);
+        if (headerSchema.properties) {
+            for (const [name, schema] of Object.entries(headerSchema.properties)) {
+                parameters.push({
+                    name,
+                    in: 'header',
+                    required: headerSchema.required?.includes(name) || false,
+                    schema: schema
+                });
+            }
+        }
+    }
+    return parameters;
+}
+//# sourceMappingURL=buildParameters.js.map