vector-framework 1.2.1 → 1.2.2

package/dist/index.cjs

@@ -0,0 +1,1434 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var{defineProperty:P,getOwnPropertyNames:Re,getOwnPropertyDescriptor:Ue}=Object,$e=Object.prototype.hasOwnProperty;var ie=new WeakMap,Pe=(e)=>{var t=ie.get(e),d;if(t)return t;if(t=P({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function")Re(e).map((n)=>!$e.call(t,n)&&P(t,n,{get:()=>e[n],enumerable:!(d=Ue(e,n))||d.enumerable}));return ie.set(e,t),t};var _e=(e,t)=>{for(var d in t)P(e,d,{get:t[d],enumerable:!0,configurable:!0,set:(n)=>t[d]=()=>n})};var wt={};_e(wt,{startVector:()=>He,route:()=>Me,createResponse:()=>I,APIError:()=>B});module.exports=Pe(wt);var v={OK:200,CREATED:201,ACCEPTED:202,NON_AUTHORITATIVE_INFORMATION:203,NO_CONTENT:204,RESET_CONTENT:205,PARTIAL_CONTENT:206,MULTI_STATUS:207,ALREADY_REPORTED:208,IM_USED:226,MULTIPLE_CHOICES:300,MOVED_PERMANENTLY:301,FOUND:302,SEE_OTHER:303,NOT_MODIFIED:304,USE_PROXY:305,TEMPORARY_REDIRECT:307,PERMANENT_REDIRECT:308,BAD_REQUEST:400,UNAUTHORIZED:401,PAYMENT_REQUIRED:402,FORBIDDEN:403,NOT_FOUND:404,METHOD_NOT_ALLOWED:405,NOT_ACCEPTABLE:406,PROXY_AUTHENTICATION_REQUIRED:407,REQUEST_TIMEOUT:408,CONFLICT:409,GONE:410,LENGTH_REQUIRED:411,PRECONDITION_FAILED:412,PAYLOAD_TOO_LARGE:413,URI_TOO_LONG:414,UNSUPPORTED_MEDIA_TYPE:415,RANGE_NOT_SATISFIABLE:416,EXPECTATION_FAILED:417,IM_A_TEAPOT:418,MISDIRECTED_REQUEST:421,UNPROCESSABLE_ENTITY:422,LOCKED:423,FAILED_DEPENDENCY:424,TOO_EARLY:425,UPGRADE_REQUIRED:426,PRECONDITION_REQUIRED:428,TOO_MANY_REQUESTS:429,REQUEST_HEADER_FIELDS_TOO_LARGE:431,UNAVAILABLE_FOR_LEGAL_REASONS:451,INTERNAL_SERVER_ERROR:500,NOT_IMPLEMENTED:501,BAD_GATEWAY:502,SERVICE_UNAVAILABLE:503,GATEWAY_TIMEOUT:504,HTTP_VERSION_NOT_SUPPORTED:505,VARIANT_ALSO_NEGOTIATES:506,INSUFFICIENT_STORAGE:507,LOOP_DETECTED:508,NOT_EXTENDED:510,NETWORK_AUTHENTICATION_REQUIRED:511},N={PORT:3000,HOSTNAME:"localhost",ROUTES_DIR:"./routes",CACHE_TTL:0,CORS_MAX_AGE:86400},_={JSON:"application/json",TEXT:"text/plain",HTML:"text/html",FORM_URLENCODED:"application/x-www-form-urlencoded",MULTIPART:"multipart/form-data"};var H={NOT_FOUND:new Response(JSON.stringify({error:!0,message:"Not Found",statusCode:404}),{status:404,headers:{"content-type":"application/json"}})};class J{protectedHandler=null;setProtectedHandler(e){this.protectedHandler=e}clearProtectedHandler(){this.protectedHandler=null}async authenticate(e){if(!this.protectedHandler)throw new Error("Protected handler not configured. Use vector.protected() to set authentication handler.");try{let t=await this.protectedHandler(e);return e.authUser=t,t}catch(t){throw new Error(`Authentication failed: ${t instanceof Error?t.message:String(t)}`)}}isAuthenticated(e){return!!e.authUser}getUser(e){return e.authUser||null}}class S{cacheHandler=null;memoryCache=new Map;cleanupInterval=null;inflight=new Map;setCacheHandler(e){this.cacheHandler=e}clearCacheHandler(){this.cacheHandler=null}async get(e,t,d=N.CACHE_TTL){if(d<=0)return t();if(this.cacheHandler)return this.cacheHandler(e,t,d);return this.getFromMemoryCache(e,t,d)}async getFromMemoryCache(e,t,d){let n=Date.now(),r=this.memoryCache.get(e);if(this.isCacheValid(r,n))return r.value;if(this.inflight.has(e))return await this.inflight.get(e);let o=(async()=>{let i=await t();return this.setInMemoryCache(e,i,d),i})();this.inflight.set(e,o);try{return await o}finally{this.inflight.delete(e)}}isCacheValid(e,t){return e!==void 0&&e.expires>t}setInMemoryCache(e,t,d){let n=Date.now()+d*1000;this.memoryCache.set(e,{value:t,expires:n}),this.scheduleCleanup()}scheduleCleanup(){if(this.cleanupInterval)return;this.cleanupInterval=setInterval(()=>{this.cleanupExpired()},60000)}cleanupExpired(){let e=Date.now();for(let[t,d]of this.memoryCache.entries())if(d.expires<=e)this.memoryCache.delete(t);if(this.memoryCache.size===0&&this.cleanupInterval)clearInterval(this.cleanupInterval),this.cleanupInterval=null}clear(){if(this.memoryCache.clear(),this.cleanupInterval)clearInterval(this.cleanupInterval),this.cleanupInterval=null}async set(e,t,d=N.CACHE_TTL){if(d<=0)return;if(this.cacheHandler){await this.cacheHandler(e,async()=>t,d);return}this.setInMemoryCache(e,t,d)}delete(e){return this.memoryCache.delete(e)}has(e){let t=this.memoryCache.get(e);if(!t)return!1;if(t.expires<=Date.now())return this.memoryCache.delete(e),!1;return!0}generateKey(e,t){let d=e._parsedUrl??new URL(e.url),n=t?.authUser?.id!=null?String(t.authUser.id):"anonymous";return`${e.method}:${d.pathname}:${d.search}:${n}`}}var F=require("fs"),A=require("path");class z{outputPath;constructor(e="./.vector/routes.generated.ts"){this.outputPath=e}async generate(e){let t=A.dirname(this.outputPath);await F.promises.mkdir(t,{recursive:!0});let d=[],n=new Map;for(let a of e){if(!n.has(a.path))n.set(a.path,[]);n.get(a.path).push(a)}let r=0,o=[];for(let[a,s]of n){let c=A.relative(A.dirname(this.outputPath),a).replace(/\\/g,"/").replace(/\.(ts|js)$/,""),m=`route_${r++}`,b=s.filter((p)=>p.name!=="default").map((p)=>p.name);if(s.some((p)=>p.name==="default"))if(b.length>0)d.push(`import ${m}, { ${b.join(", ")} } from '${c}';`);else d.push(`import ${m} from '${c}';`);else if(b.length>0)d.push(`import { ${b.join(", ")} } from '${c}';`);for(let p of s){let x=p.name==="default"?m:p.name;o.push(`  ${x},`)}}let i=`// This file is auto-generated. Do not edit manually.
+// Generated at: ${new Date().toISOString()}
+
+${d.join(`
+`)}
+
+export const routes = [
+${o.join(`
+`)}
+];
+
+export default routes;
+`;await F.promises.writeFile(this.outputPath,i,"utf-8")}async generateDynamic(e){let t=[];for(let d of e){let n=JSON.stringify({method:d.method,path:d.options.path,options:d.options});t.push(`  await import('${d.path}').then(m => ({ 
+        ...${n}, 
+        handler: m.${d.name==="default"?"default":d.name} 
+      }))`)}return`export const loadRoutes = async () => {
+  return Promise.all([
+${t.join(`,
+`)}
+  ]);
+};`}}var j=require("fs"),k=require("path");class O{routesDir;excludePatterns;static DEFAULT_EXCLUDE_PATTERNS=["*.test.ts","*.test.js","*.test.tsx","*.test.jsx","*.spec.ts","*.spec.js","*.spec.tsx","*.spec.jsx","*.tests.ts","*.tests.js","**/__tests__/**","*.interface.ts","*.type.ts","*.d.ts"];constructor(e="./routes",t){this.routesDir=k.resolve(process.cwd(),e),this.excludePatterns=t||O.DEFAULT_EXCLUDE_PATTERNS}async scan(){let e=[];if(!j.existsSync(this.routesDir))return[];try{await this.scanDirectory(this.routesDir,e)}catch(t){if(t.code==="ENOENT")return console.warn(`  \u2717 Routes directory not accessible: ${this.routesDir}`),[];throw t}return e}isExcluded(e){let t=k.relative(this.routesDir,e);for(let d of this.excludePatterns){let n=d.replace(/\./g,"\\.").replace(/\*\*/g,"__GLOBSTAR__").replace(/\*/g,"[^/]*").replace(/__GLOBSTAR__/g,".*").replace(/\?/g,"."),r=new RegExp(`^${n}$`),o=t.split(k.sep).pop()||"";if(r.test(t)||r.test(o))return!0}return!1}async scanDirectory(e,t,d=""){let n=await j.promises.readdir(e);for(let r of n){let o=k.join(e,r);if((await j.promises.stat(o)).isDirectory()){let a=d?`${d}/${r}`:r;await this.scanDirectory(o,t,a)}else if(r.endsWith(".ts")||r.endsWith(".js")){if(this.isExcluded(o))continue;let a=k.relative(this.routesDir,o).replace(/\.(ts|js)$/,"").split(k.sep).join("/");try{let c=await import(process.platform==="win32"?`file:///${o.replace(/\\/g,"/")}`:o);if(c.default&&typeof c.default==="function")t.push({name:"default",path:o,method:"GET",options:{method:"GET",path:`/${a}`,expose:!0}});for(let[m,b]of Object.entries(c)){if(m==="default")continue;if(b&&typeof b==="object"&&"entry"in b&&"options"in b&&"handler"in b){let p=b;t.push({name:m,path:o,method:p.options.method,options:p.options})}else if(Array.isArray(b)&&b.length>=4){let[p,,,x]=b;t.push({name:m,path:o,method:p,options:{method:p,path:x,expose:!0}})}}}catch(s){console.error(`Failed to load route from ${o}:`,s)}}}}enableWatch(e){if(typeof Bun!=="undefined"&&Bun.env.NODE_ENV==="development")console.log(`Watching for route changes in ${this.routesDir}`),setInterval(async()=>{await e()},1000)}}class T{beforeHandlers=[];finallyHandlers=[];addBefore(...e){this.beforeHandlers.push(...e)}addFinally(...e){this.finallyHandlers.push(...e)}async executeBefore(e){if(this.beforeHandlers.length===0)return e;let t=e;for(let d of this.beforeHandlers){let n=await d(t);if(n instanceof Response)return n;t=n}return t}async executeFinally(e,t){if(this.finallyHandlers.length===0)return e;let d=e;for(let n of this.finallyHandlers)try{d=await n(d,t)}catch(r){console.error("After middleware error:",r)}return d}clone(){let e=new T;return e.beforeHandlers=[...this.beforeHandlers],e.finallyHandlers=[...this.finallyHandlers],e}clear(){this.beforeHandlers=[],this.finallyHandlers=[]}}function R(e){return process.platform==="win32"?`file:///${e.replace(/\\/g,"/")}`:e}function G(e){return RegExp(`^${e.replace(/\/+(\/|$)/g,"$1").replace(/(\/?\.?):(\w+)\+/g,"($1(?<$2>[\\s\\S]+))").replace(/(\/?\.?):(\w+)/g,"($1(?<$2>[^$1/]+?))").replace(/\./g,"\\.").replace(/(\/?)\*/g,"($1.*)?")}/*$`)}function se(e){let t=e?.["~standard"];return!!t&&typeof t==="object"&&typeof t.validate==="function"&&t.version===1}async function le(e,t){let d=await e["~standard"].validate(t),n=d?.issues;if(Array.isArray(n)&&n.length>0)return{success:!1,issues:n};return{success:!0,value:d?.value}}function ce(e){if(Array.isArray(e))return e;if(e&&typeof e==="object"&&Array.isArray(e.issues))return e.issues;if(e&&typeof e==="object"&&e.cause&&Array.isArray(e.cause.issues))return e.cause.issues;return null}function Je(e){if(!Array.isArray(e))return[];let t=[];for(let d=0;d<e.length;d++){let n=e[d],r=n;if(n&&typeof n==="object"&&"key"in n)r=n.key;if(typeof r==="string"||typeof r==="number")t.push(r);else if(typeof r==="symbol")t.push(String(r));else if(r!==void 0&&r!==null)t.push(String(r))}return t}function V(e,t){let d=[];for(let n=0;n<e.length;n++){let r=e[n],o=r,i={message:typeof o?.message==="string"&&o.message.length>0?o.message:"Invalid value",path:Je(o?.path)};if(typeof o?.code==="string")i.code=o.code;if(t)i.raw=r;d.push(i)}return d}function Q(e,t){return{error:!0,message:"Validation failed",statusCode:422,source:"validation",target:e,issues:t,timestamp:new Date().toISOString()}}class M{middlewareManager;authManager;cacheManager;routeBooleanDefaults={};developmentMode=void 0;routeDefinitions=[];routeTable=Object.create(null);routeMatchers=[];corsHeadersEntries=null;corsHandler=null;constructor(e,t,d){this.middlewareManager=e,this.authManager=t,this.cacheManager=d}setCorsHeaders(e){this.corsHeadersEntries=e}setCorsHandler(e){this.corsHandler=e}setRouteBooleanDefaults(e){this.routeBooleanDefaults={...e}}setDevelopmentMode(e){this.developmentMode=e}applyRouteBooleanDefaults(e){let t={...e},d=this.routeBooleanDefaults,n=["auth","expose","rawRequest","validate","rawResponse"];for(let r of n)if(t[r]===void 0&&d[r]!==void 0)t[r]=d[r];return t}route(e,t){let d=this.applyRouteBooleanDefaults(e),n=d.method.toUpperCase(),r=d.path,o=this.wrapHandler(d,t),i=this.getOrCreateMethodMap(r);i[n]=o,this.routeDefinitions.push({method:n,path:r,options:d})}addRoute(e){let[t,,d,n]=e;if(!n)return;let r=this.getOrCreateMethodMap(n);r[t.toUpperCase()]=d[0];let o=t.toUpperCase();this.routeDefinitions.push({method:o,path:n,options:{method:o,path:n,expose:!0}})}bulkAddRoutes(e){for(let t of e)this.addRoute(t)}addStaticRoute(e,t){let d=this.routeTable[e];if(d&&!(d instanceof Response))throw new Error(`Cannot register static route for path "${e}" because method routes already exist.`);this.routeTable[e]=t,this.removeRouteMatcher(e)}getRouteTable(){return this.routeTable}getRoutes(){let e=[];for(let t of this.routeMatchers){let d=this.routeTable[t.path];if(!d||d instanceof Response)continue;for(let[n,r]of Object.entries(d))e.push([n,t.regex,[r],t.path])}return e}getRouteDefinitions(){return[...this.routeDefinitions]}clearRoutes(){this.routeTable=Object.create(null),this.routeMatchers=[],this.routeDefinitions=[]}sortRoutes(){}async handle(e){let t;try{t=new URL(e.url)}catch{return B.badRequest("Malformed request URL")}e._parsedUrl=t;let d=t.pathname;for(let n of this.routeMatchers){let r=n.path,o=this.routeTable[r];if(!o)continue;if(o instanceof Response)continue;let i=o;if(e.method==="OPTIONS"||e.method in i){let a=d.match(n.regex);if(a){try{e.params=a.groups??{}}catch{}let s=i[e.method]??i.GET;if(s){let c=await s(e);if(c)return c}}}}return H.NOT_FOUND.clone()}prepareRequest(e,t){if(!e.context)e.context={};let d=!!e.params&&typeof e.params==="object"&&!Array.isArray(e.params)&&Object.keys(e.params).length===0;if(t?.params!==void 0&&(e.params===void 0||d))try{e.params=t.params}catch{}if(t?.route!==void 0)e.route=t.route;if(t?.metadata!==void 0)e.metadata=t.metadata;if(e.query==null&&e.url)try{Object.defineProperty(e,"query",{get(){let n=this._parsedUrl??new URL(this.url),r=M.parseQuery(n);return Object.defineProperty(this,"query",{value:r,writable:!0,configurable:!0,enumerable:!0}),r},set(n){Object.defineProperty(this,"query",{value:n,writable:!0,configurable:!0,enumerable:!0})},configurable:!0,enumerable:!0})}catch{let n=e._parsedUrl??new URL(e.url);try{e.query=M.parseQuery(n)}catch{}}if(!Object.getOwnPropertyDescriptor(e,"cookies"))Object.defineProperty(e,"cookies",{get(){let n=this.headers.get("cookie")??"",r={};if(n)for(let o of n.split(";")){let i=o.indexOf("=");if(i>0)r[o.slice(0,i).trim()]=o.slice(i+1).trim()}return Object.defineProperty(this,"cookies",{value:r,writable:!0,configurable:!0,enumerable:!0}),r},configurable:!0,enumerable:!0})}resolveFallbackParams(e,t){if(!t)return;let d=e.params;if(d&&typeof d==="object"&&!Array.isArray(d)&&Object.keys(d).length>0)return;let n;try{n=(e._parsedUrl??new URL(e.url)).pathname}catch{return}let r=n.match(t);if(!r?.groups)return;return r.groups}wrapHandler(e,t){let d=e.path,n=d.includes(":")?G(d):null;return async(r)=>{let o=r,i=this.resolveFallbackParams(r,n);this.prepareRequest(o,{params:i,route:d,metadata:e.metadata});try{if(e.expose===!1)return B.forbidden("Forbidden");let a=await this.middlewareManager.executeBefore(o);if(a instanceof Response)return a;let s=a;if(e.auth)try{await this.authManager.authenticate(s)}catch(u){return B.unauthorized(u instanceof Error?u.message:"Authentication failed",e.responseContentType)}if(!e.rawRequest&&s.method!=="GET"&&s.method!=="HEAD"){let u=null;try{let f=s.headers.get("content-type");if(f?.startsWith("application/json"))u=await s.json();else if(f?.startsWith("application/x-www-form-urlencoded"))u=Object.fromEntries(await s.formData());else if(f?.startsWith("multipart/form-data"))u=await s.formData();else u=await s.text()}catch{u=null}this.setContentAndBodyAlias(s,u)}let c=await this.validateInputSchema(s,e);if(c)return c;let m,b=e.cache;if(b&&typeof b==="number"&&b>0){let u=this.cacheManager.generateKey(s,{authUser:s.authUser});m=await this.cacheManager.get(u,async()=>{let f=await t(s);if(f instanceof Response)return{_isResponse:!0,body:await f.text(),status:f.status,headers:Object.fromEntries(f.headers.entries())};return f},b)}else if(b&&typeof b==="object"&&b.ttl){let u=b.key||this.cacheManager.generateKey(s,{authUser:s.authUser});m=await this.cacheManager.get(u,async()=>{let f=await t(s);if(f instanceof Response)return{_isResponse:!0,body:await f.text(),status:f.status,headers:Object.fromEntries(f.headers.entries())};return f},b.ttl)}else m=await t(s);if(m&&typeof m==="object"&&m._isResponse===!0)m=new Response(m.body,{status:m.status,headers:m.headers});let p;if(e.rawResponse||m instanceof Response)p=m instanceof Response?m:new Response(m);else p=I(200,m,e.responseContentType);p=await this.middlewareManager.executeFinally(p,s);let x=this.corsHeadersEntries;if(x)for(let[u,f]of x)p.headers.set(u,f);else{let u=this.corsHandler;if(u)p=u(p,s)}return p}catch(a){if(a instanceof Response)return a;return console.error("Route handler error:",a),B.internalServerError(a instanceof Error?a.message:String(a),e.responseContentType)}}}isDevelopmentMode(){if(this.developmentMode!==void 0)return this.developmentMode;return(typeof Bun!=="undefined"?Bun.env.NODE_ENV:"development")!=="production"}async buildInputValidationPayload(e,t){let d=e.content;if(t.rawRequest&&e.method!=="GET"&&e.method!=="HEAD")try{d=await e.clone().text()}catch{d=null}return{params:e.params??{},query:e.query??{},headers:Object.fromEntries(e.headers.entries()),cookies:e.cookies??{},body:d}}applyValidatedInput(e,t){if(e.validatedInput=t,!t||typeof t!=="object")return;let d=t;if("params"in d)try{e.params=d.params}catch{}if("query"in d)try{e.query=d.query}catch{}if("cookies"in d)try{e.cookies=d.cookies}catch{}if("body"in d)this.setContentAndBodyAlias(e,d.body)}setContentAndBodyAlias(e,t){try{e.content=t}catch{return}this.setBodyAlias(e,t)}setBodyAlias(e,t){try{e.body=t}catch{}}async validateInputSchema(e,t){let d=t.schema?.input;if(!d)return null;if(t.validate===!1)return null;if(!se(d))return B.internalServerError("Invalid route schema configuration",t.responseContentType);let n=this.isDevelopmentMode(),r=await this.buildInputValidationPayload(e,t);try{let o=await le(d,r);if(o.success===!1){let i=V(o.issues,n);return I(422,Q("input",i),t.responseContentType)}return this.applyValidatedInput(e,o.value),null}catch(o){let i=ce(o);if(i){let a=V(i,n);return I(422,Q("input",a),t.responseContentType)}return B.internalServerError(o instanceof Error?o.message:"Validation failed",t.responseContentType)}}getOrCreateMethodMap(e){let t=this.routeTable[e];if(t instanceof Response)throw new Error(`Cannot register method route for path "${e}" because a static route already exists.`);if(t)return t;let d=Object.create(null);return this.routeTable[e]=d,this.addRouteMatcher(e),d}addRouteMatcher(e){if(this.routeMatchers.some((t)=>t.path===e))return;this.routeMatchers.push({path:e,regex:G(e),specificity:this.routeSpecificityScore(e)}),this.routeMatchers.sort((t,d)=>{if(t.specificity!==d.specificity)return d.specificity-t.specificity;return t.path.localeCompare(d.path)})}removeRouteMatcher(e){this.routeMatchers=this.routeMatchers.filter((t)=>t.path!==e)}static parseQuery(e){let t={};for(let[d,n]of e.searchParams)if(d in t){let r=t[d];if(Array.isArray(r))r.push(n);else t[d]=[r,n]}else t[d]=n;return t}routeSpecificityScore(e){let o=e.split("/").filter(Boolean),i=0;for(let a of o)if(a.includes("*"))i+=1;else if(a.startsWith(":"))i+=10;else i+=1000;if(i+=e.length,!e.includes(":")&&!e.includes("*"))i+=1e4;return i}}var ne=require("fs"),Le=require("path");function be(e,t){if(!e){if(typeof t.origin==="string"){if(t.origin==="*"&&t.credentials)return null;return t.origin}return null}if(typeof t.origin==="string"){if(t.origin==="*")return t.credentials?e:"*";return t.origin===e?e:null}if(Array.isArray(t.origin))return t.origin.includes(e)?e:null;if(typeof t.origin==="function")return t.origin(e)?e:null;return null}function me(e){return typeof e.origin==="string"&&e.origin==="*"&&e.credentials||Array.isArray(e.origin)||typeof e.origin==="function"}function pe(e,t,d){let n={};if(e){if(n["access-control-allow-origin"]=e,n["access-control-allow-methods"]=t.allowMethods,n["access-control-allow-headers"]=t.allowHeaders,n["access-control-expose-headers"]=t.exposeHeaders,n["access-control-max-age"]=String(t.maxAge),t.credentials)n["access-control-allow-credentials"]="true";if(d)n.vary="Origin"}return n}function Se(e,t){if(!e)return t;let d=e.split(",").map((r)=>r.trim()).filter(Boolean);if(!d.map((r)=>r.toLowerCase()).includes(t.toLowerCase()))d.push(t);return d.join(", ")}function ue(e){return{preflight(t){let d=t.headers.get("origin")??void 0,n=be(d,e),r=Boolean(d&&n&&me(e));return new Response(null,{status:204,headers:pe(n,e,r)})},corsify(t,d){let n=d.headers.get("origin")??void 0,r=be(n,e);if(!r)return t;let o=Boolean(n&&me(e)),i=pe(r,e,o);for(let[a,s]of Object.entries(i)){if(a==="vary"){t.headers.set("vary",Se(t.headers.get("vary"),s));continue}t.headers.set(a,s)}return t}}}function fe(e,t,d,n,r,o,i,a,s){let c=JSON.stringify(e).replace(/<\/script/gi,"<\\/script"),m=JSON.stringify(t),b=JSON.stringify(d),p=JSON.stringify(n),x=JSON.stringify(r),u=JSON.stringify(o),f=JSON.stringify(i),Oe=JSON.stringify(a),Te=JSON.stringify(s);return`<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Vector API Documentation</title>
+  <link rel="apple-touch-icon" sizes="180x180" href=${u}>
+  <link rel="icon" type="image/png" sizes="32x32" href=${f}>
+  <link rel="icon" type="image/png" sizes="16x16" href=${Oe}>
+  <link rel="manifest" href=${Te}>
+  <script>
+    if (localStorage.getItem('theme') === 'dark' || (!('theme' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
+      document.documentElement.classList.add('dark');
+    } else {
+      document.documentElement.classList.remove('dark');
+    }
+  </script>
+  <script src=${b}></script>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+  <script>
+    tailwind.config = {
+      darkMode: 'class',
+      theme: {
+        extend: {
+          colors: {
+            brand: {
+              DEFAULT: '#00A1FF',
+              mint: '#00FF8F',
+              soft: '#E4F5FF',
+              deep: '#007BC5',
+            },
+            dark: { bg: '#0A0A0A', surface: '#111111', border: '#1F1F1F', text: '#EDEDED' },
+            light: { bg: '#FFFFFF', surface: '#F9F9F9', border: '#E5E5E5', text: '#111111' }
+          },
+          fontFamily: {
+            sans: ['Inter', 'sans-serif'],
+            mono: ['JetBrains Mono', 'monospace'],
+          }
+        }
+      }
+    };
+  </script>
+  <style>
+    :root {
+      --motion-fast: 180ms;
+      --motion-base: 280ms;
+      --motion-slow: 420ms;
+      --motion-ease: cubic-bezier(0.22, 1, 0.36, 1);
+    }
+    ::-webkit-scrollbar { width: 8px; height: 8px; }
+    ::-webkit-scrollbar-track { background: transparent; }
+    ::-webkit-scrollbar-thumb { background: #333; border-radius: 4px; }
+    body { transition: background-color 150ms ease, color 150ms ease; }
+    #sidebar-nav a,
+    #send-btn,
+    #copy-curl,
+    #add-header-btn,
+    #expand-body-btn,
+    #expand-response-btn,
+    #expand-close,
+    #expand-apply {
+      transition:
+        transform var(--motion-fast) var(--motion-ease),
+        opacity var(--motion-fast) var(--motion-ease),
+        border-color var(--motion-fast) var(--motion-ease),
+        background-color var(--motion-fast) var(--motion-ease),
+        color var(--motion-fast) var(--motion-ease);
+      will-change: transform, opacity;
+    }
+    #sidebar-nav a:hover,
+    #send-btn:hover,
+    #add-header-btn:hover,
+    #expand-body-btn:hover,
+    #expand-response-btn:hover {
+      transform: translateY(-1px);
+    }
+    #endpoint-card {
+      transition:
+        box-shadow var(--motion-base) var(--motion-ease),
+        transform var(--motion-base) var(--motion-ease),
+        opacity var(--motion-base) var(--motion-ease);
+    }
+    .enter-fade-up {
+      animation: enterFadeUp var(--motion-base) var(--motion-ease) both;
+    }
+    .enter-stagger {
+      animation: enterStagger var(--motion-base) var(--motion-ease) both;
+      animation-delay: var(--stagger-delay, 0ms);
+    }
+    @keyframes enterFadeUp {
+      from { opacity: 0; transform: translateY(8px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    @keyframes enterStagger {
+      from { opacity: 0; transform: translateX(-6px); }
+      to { opacity: 1; transform: translateX(0); }
+    }
+    @keyframes spin {
+      to { transform: rotate(360deg); }
+    }
+    .button-spinner {
+      display: inline-block;
+      width: 0.875rem;
+      height: 0.875rem;
+      border: 2px solid currentColor;
+      border-right-color: transparent;
+      border-radius: 9999px;
+      animation: spin 700ms linear infinite;
+    }
+    @media (prefers-reduced-motion: reduce) {
+      *, *::before, *::after {
+        animation: none !important;
+        transition: none !important;
+      }
+    }
+    .json-key { color: #007bc5; }
+    .json-string { color: #334155; }
+    .json-number { color: #00a1ff; }
+    .json-boolean { color: #475569; }
+    .json-null { color: #64748b; }
+    .dark .json-key { color: #7dc9ff; }
+    .dark .json-string { color: #d1d9e6; }
+    .dark .json-number { color: #7dc9ff; }
+    .dark .json-boolean { color: #93a4bf; }
+    .dark .json-null { color: #7c8ba3; }
+  </style>
+</head>
+<body class="bg-light-bg text-light-text dark:bg-dark-bg dark:text-dark-text font-sans antialiased flex h-screen overflow-hidden">
+  <div id="mobile-backdrop" class="fixed inset-0 z-30 bg-black/40 opacity-0 pointer-events-none transition-opacity duration-300 md:hidden"></div>
+  <aside id="docs-sidebar" class="fixed inset-y-0 left-0 z-40 w-72 md:w-64 border-r border-light-border dark:border-dark-border bg-light-surface dark:bg-dark-surface flex flex-col flex-shrink-0 transition-transform duration-300 ease-out -translate-x-full md:translate-x-0 md:static md:z-auto transition-colors duration-150">
+    <div class="h-14 flex items-center px-5 border-b border-light-border dark:border-dark-border">
+      <div class="flex items-center">
+        <img src=${p} alt="Vector" class="h-6 w-auto block dark:hidden" />
+        <img src=${x} alt="Vector" class="h-6 w-auto hidden dark:block" />
+      </div>
+      <button id="sidebar-close" class="ml-auto p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-bg/90 dark:bg-dark-bg/90 opacity-90 hover:opacity-100 transition md:hidden" aria-label="Close Menu" title="Close Menu">
+        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path>
+        </svg>
+      </button>
+    </div>
+    <div class="p-4">
+      <div class="relative">
+        <svg class="w-4 h-4 absolute left-3 top-1/2 -translate-y-1/2 opacity-60" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"></path>
+        </svg>
+        <input
+          id="sidebar-search"
+          type="text"
+          placeholder="Search routes..."
+          class="w-full pl-9 pr-3 py-2 text-sm rounded-md border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg focus:outline-none focus:border-brand dark:focus:border-brand transition-colors"
+        />
+      </div>
+    </div>
+    <nav class="flex-1 overflow-y-auto px-3 py-2 space-y-6 text-sm" id="sidebar-nav"></nav>
+  </aside>
+
+  <main class="flex-1 flex flex-col min-w-0 relative">
+    <header class="h-14 flex items-center justify-between px-6 border-b border-light-border dark:border-dark-border lg:border-none lg:bg-transparent absolute top-0 w-full z-10 bg-light-bg/80 dark:bg-dark-bg/80 backdrop-blur-sm transition-colors duration-150">
+      <div class="md:hidden flex items-center gap-2">
+        <button id="sidebar-open" class="p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-bg/90 dark:bg-dark-bg/90 opacity-90 hover:opacity-100 transition" aria-label="Open Menu" title="Open Menu">
+          <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"></path>
+          </svg>
+        </button>
+        <img src=${p} alt="Vector" class="h-5 w-auto block dark:hidden" />
+        <img src=${x} alt="Vector" class="h-5 w-auto hidden dark:block" />
+      </div>
+      <div class="flex-1"></div>
+      <button id="theme-toggle" class="p-2 rounded-md hover:bg-black/5 dark:hover:bg-white/5 transition-colors" aria-label="Toggle Dark Mode">
+        <svg class="w-5 h-5 hidden dark:block text-dark-text" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"></path></svg>
+        <svg class="w-5 h-5 block dark:hidden text-light-text" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"></path></svg>
+      </button>
+    </header>
+
+    <div class="flex-1 overflow-y-auto pt-14 pb-24">
+      <div class="max-w-[860px] mx-auto px-6 py-12 lg:py-16">
+        <div class="mb-12">
+          <h1 class="text-4xl font-bold tracking-tight mb-4" id="tag-title">API</h1>
+          <p class="text-lg opacity-80 max-w-2xl leading-relaxed" id="tag-description">Interactive API documentation.</p>
+        </div>
+        <hr class="border-t border-light-border dark:border-dark-border mb-12">
+        <div class="mb-20" id="endpoint-card">
+          <div class="flex items-center gap-3 mb-4">
+             <span id="endpoint-method" class="px-2.5 py-0.5 rounded-full text-xs font-mono font-medium"></span>
+             <h2 class="text-xl font-semibold tracking-tight" id="endpoint-title">Operation</h2>
+          </div>
+          <p class="text-sm opacity-80 mb-8 font-mono" id="endpoint-path">/</p>
+          <div class="grid grid-cols-1 lg:grid-cols-12 gap-10">
+            <div class="lg:col-span-5 space-y-8" id="params-column"></div>
+            <div class="lg:col-span-7">
+              <div class="rounded-lg border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg overflow-hidden group">
+                <div class="flex items-center justify-between px-4 py-2 border-b border-light-border dark:border-dark-border bg-light-surface dark:bg-dark-surface">
+                   <span class="text-xs font-mono text-light-text/70 dark:text-dark-text/70">cURL</span>
+                   <button class="text-xs text-light-text/50 hover:text-light-text dark:text-dark-text/50 dark:hover:text-dark-text transition-colors" id="copy-curl">Copy</button>
+                </div>
+                <pre class="p-4 text-sm font-mono text-light-text dark:text-dark-text overflow-x-auto leading-relaxed"><code id="curl-code"></code></pre>
+              </div>
+              <div class="mt-4 p-4 rounded-lg border border-light-border dark:border-dark-border bg-light-surface dark:bg-dark-surface">
+                <div class="flex items-center justify-between mb-3">
+                  <h4 class="text-sm font-medium">Try it out</h4>
+                  <button id="send-btn" class="px-4 py-1.5 bg-brand text-white text-sm font-semibold rounded hover:bg-brand-deep transition-colors">
+                    <span class="inline-flex items-center gap-2">
+                      <span id="send-btn-spinner" class="button-spinner hidden" aria-hidden="true"></span>
+                      <span id="send-btn-label">Submit</span>
+                    </span>
+                  </button>
+                </div>
+                <div class="space-y-4">
+                  <div>
+                    <div id="request-param-inputs" class="space-y-3"></div>
+                  </div>
+
+                  <div>
+                    <div class="flex items-center justify-between mb-2">
+                      <p class="text-xs font-semibold uppercase tracking-wider opacity-60">Headers</p>
+                      <button id="add-header-btn" class="p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-bg/90 dark:bg-dark-bg/90 opacity-90 hover:opacity-100 hover:border-brand/60 transition-colors" aria-label="Add Header" title="Add Header">
+                        <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 5v14m-7-7h14"></path>
+                        </svg>
+                      </button>
+                    </div>
+                    <div id="header-inputs" class="space-y-2"></div>
+                  </div>
+
+                  <div id="request-body-section">
+                    <div class="flex items-center justify-between mb-2">
+                      <p class="text-xs font-semibold uppercase tracking-wider opacity-60">Request Body</p>
+                    </div>
+                    <div class="relative h-40 rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg overflow-hidden">
+                      <pre id="body-highlight" class="absolute inset-0 m-0 p-3 pr-11 text-xs font-mono leading-5 overflow-auto whitespace-pre-wrap break-words pointer-events-none"></pre>
+                      <textarea id="body-input" class="absolute inset-0 w-full h-full p-3 pr-11 text-xs font-mono leading-5 bg-transparent text-transparent caret-black dark:caret-white resize-none focus:outline-none overflow-auto placeholder:text-light-text/50 dark:placeholder:text-dark-text/40" placeholder='{"key":"value"}' spellcheck="false" autocapitalize="off" autocorrect="off"></textarea>
+                      <button id="expand-body-btn" class="absolute bottom-2 right-2 p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-surface/95 dark:bg-dark-surface/95 opacity-90 hover:opacity-100 hover:border-brand/60 transition-colors" aria-label="Expand Request Body" title="Expand Request Body">
+                        <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 9V4h5M20 15v5h-5M15 4h5v5M9 20H4v-5"></path>
+                        </svg>
+                      </button>
+                    </div>
+                  </div>
+
+                  <div id="response-section">
+                    <div class="flex items-center justify-between mb-2">
+                      <p class="text-xs font-semibold uppercase tracking-wider opacity-60">Response</p>
+                    </div>
+                    <div class="relative">
+                      <pre id="result" class="p-3 pr-11 text-xs font-mono rounded border border-light-border dark:border-dark-border overflow-x-auto min-h-[140px]"></pre>
+                      <button id="expand-response-btn" class="absolute bottom-2 right-2 p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-surface/95 dark:bg-dark-surface/95 opacity-90 hover:opacity-100 hover:border-brand/60 transition-colors" aria-label="Expand Response" title="Expand Response">
+                        <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 9V4h5M20 15v5h-5M15 4h5v5M9 20H4v-5"></path>
+                        </svg>
+                      </button>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </main>
+
+  <div id="expand-modal" class="fixed inset-0 z-50 hidden items-center justify-center bg-black/60 p-4">
+    <div class="w-full max-w-5xl rounded-lg border border-light-border dark:border-dark-border bg-light-surface dark:bg-dark-surface p-4">
+      <div class="flex items-center justify-between mb-3">
+        <h3 id="expand-modal-title" class="text-sm font-semibold">Expanded View</h3>
+        <div class="flex items-center gap-2">
+          <button id="expand-apply" class="hidden text-sm px-3 py-1.5 rounded bg-brand text-white font-semibold hover:bg-brand-deep transition-colors">Apply</button>
+          <button id="expand-close" class="p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-bg/90 dark:bg-dark-bg/90 opacity-90 hover:opacity-100 hover:border-brand/60 transition-colors" aria-label="Close Modal" title="Close Modal">
+            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path>
+            </svg>
+          </button>
+        </div>
+      </div>
+      <div id="expand-editor-shell" class="hidden relative w-full h-[70vh] rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg overflow-hidden">
+        <pre id="expand-editor-highlight" class="absolute inset-0 m-0 p-3 text-sm font-mono leading-6 overflow-auto whitespace-pre-wrap break-words pointer-events-none"></pre>
+        <textarea id="expand-editor" class="absolute inset-0 w-full h-full p-3 text-sm font-mono leading-6 bg-transparent text-transparent caret-black dark:caret-white resize-none focus:outline-none overflow-auto" spellcheck="false" autocapitalize="off" autocorrect="off"></textarea>
+      </div>
+      <pre id="expand-viewer" class="hidden w-full h-[70vh] text-sm p-3 rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg overflow-auto font-mono"></pre>
+    </div>
+  </div>
+
+  <script>
+    const spec = ${c};
+    const openapiPath = ${m};
+    const methodBadgeDefault = "bg-black/5 text-light-text/80 dark:bg-white/10 dark:text-dark-text/80";
+    const methodBadge = {
+      GET: "bg-brand-soft text-brand-deep dark:bg-brand/20 dark:text-brand",
+      POST: "bg-brand-soft text-brand-deep dark:bg-brand/20 dark:text-brand",
+      PUT: "bg-brand-soft text-brand-deep dark:bg-brand/20 dark:text-brand",
+      PATCH: "bg-brand-soft text-brand-deep dark:bg-brand/20 dark:text-brand",
+      DELETE: "bg-brand-soft text-brand-deep dark:bg-brand/20 dark:text-brand",
+    };
+
+    function getOperations() {
+      const httpMethods = new Set([
+        "get",
+        "post",
+        "put",
+        "patch",
+        "delete",
+        "head",
+        "options",
+      ]);
+
+      const humanizePath = (path) =>
+        path
+          .replace(/^\\/+/, "")
+          .replace(/[{}]/g, "")
+          .replace(/[\\/_]+/g, " ")
+          .trim() || "root";
+
+      const toTitleCase = (value) =>
+        value.replace(/\\w\\S*/g, (word) => word.charAt(0).toUpperCase() + word.slice(1));
+
+      const getDisplayName = (op, method, path) => {
+        if (typeof op.summary === "string" && op.summary.trim()) {
+          return op.summary.trim();
+        }
+
+        if (typeof op.operationId === "string" && op.operationId.trim()) {
+          const withoutPrefix = op.operationId.replace(
+            new RegExp("^" + method + "_+", "i"),
+            "",
+          );
+          const readable = withoutPrefix.replace(/_+/g, " ").trim();
+          if (readable) return toTitleCase(readable);
+        }
+
+        return toTitleCase(humanizePath(path));
+      };
+
+      const ops = [];
+      const paths = spec.paths || {};
+      for (const path of Object.keys(paths)) {
+        const methods = paths[path] || {};
+        for (const method of Object.keys(methods)) {
+          if (!httpMethods.has(method)) continue;
+          const op = methods[method];
+          ops.push({
+            path,
+            method: method.toUpperCase(),
+            operation: op,
+            tag: (op.tags && op.tags[0]) || "default",
+            name: getDisplayName(op, method, path),
+          });
+        }
+      }
+      return ops;
+    }
+
+    const operations = getOperations();
+    let selected = operations[0] || null;
+    const operationParamValues = new Map();
+    const operationBodyDrafts = new Map();
+    const requestHeaders = [{ key: "Authorization", value: "" }];
+    let expandModalMode = null;
+    let isMobileSidebarOpen = false;
+    let sidebarSearchQuery = "";
+
+    function setMobileSidebarOpen(open) {
+      const sidebar = document.getElementById("docs-sidebar");
+      const backdrop = document.getElementById("mobile-backdrop");
+      const openBtn = document.getElementById("sidebar-open");
+      if (!sidebar || !backdrop || !openBtn) return;
+
+      isMobileSidebarOpen = open;
+      sidebar.classList.toggle("-translate-x-full", !open);
+      backdrop.classList.toggle("opacity-0", !open);
+      backdrop.classList.toggle("pointer-events-none", !open);
+      openBtn.setAttribute("aria-expanded", open ? "true" : "false");
+      document.body.classList.toggle("overflow-hidden", open);
+    }
+
+    function getOperationKey(op) {
+      return op.method + " " + op.path;
+    }
+
+    function getOperationParameterGroups(op) {
+      const params =
+        op &&
+        op.operation &&
+        Array.isArray(op.operation.parameters)
+          ? op.operation.parameters
+          : [];
+
+      return {
+        all: params,
+        path: params.filter((p) => p.in === "path"),
+        query: params.filter((p) => p.in === "query"),
+        headers: params.filter((p) => p.in === "header"),
+      };
+    }
+
+    function getParameterValues(op) {
+      const key = getOperationKey(op);
+      if (!operationParamValues.has(key)) {
+        operationParamValues.set(key, {});
+      }
+      return operationParamValues.get(key);
+    }
+
+    function getBodyDraft(op) {
+      const key = getOperationKey(op);
+      return operationBodyDrafts.get(key);
+    }
+
+    function setBodyDraft(op, bodyValue) {
+      const key = getOperationKey(op);
+      operationBodyDrafts.set(key, bodyValue);
+    }
+
+    function resolvePath(pathTemplate, pathParams, values) {
+      let resolved = pathTemplate;
+      for (const param of pathParams) {
+        const rawValue = values[param.name];
+        if (rawValue === undefined || rawValue === null || rawValue === "") {
+          continue;
+        }
+        const placeholder = "{" + param.name + "}";
+        resolved = resolved
+          .split(placeholder)
+          .join(encodeURIComponent(String(rawValue)));
+      }
+      return resolved;
+    }
+
+    function buildRequestPath(op, pathParams, queryParams, values) {
+      const resolvedPath = resolvePath(op.path, pathParams, values);
+      const query = new URLSearchParams();
+
+      for (const param of queryParams) {
+        const rawValue = values[param.name];
+        if (rawValue === undefined || rawValue === null || rawValue === "") {
+          continue;
+        }
+        query.append(param.name, String(rawValue));
+      }
+
+      const queryString = query.toString();
+      return queryString ? resolvedPath + "?" + queryString : resolvedPath;
+    }
+
+    function schemaDefaultValue(schema) {
+      if (!schema || typeof schema !== "object") return null;
+      if (schema.default !== undefined) return schema.default;
+      if (schema.example !== undefined) return schema.example;
+      if (Array.isArray(schema.enum) && schema.enum.length > 0) return schema.enum[0];
+      if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) {
+        return schemaDefaultValue(schema.oneOf[0]);
+      }
+      if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
+        return schemaDefaultValue(schema.anyOf[0]);
+      }
+      if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {
+        return schemaDefaultValue(schema.allOf[0]);
+      }
+
+      switch (schema.type) {
+        case "string":
+          return "";
+        case "number":
+        case "integer":
+          return 0;
+        case "boolean":
+          return false;
+        case "array":
+          return [];
+        case "object": {
+          const required = Array.isArray(schema.required) ? schema.required : [];
+          const properties = schema.properties && typeof schema.properties === "object"
+            ? schema.properties
+            : {};
+          const obj = {};
+          for (const fieldName of required) {
+            obj[fieldName] = schemaDefaultValue(properties[fieldName]);
+          }
+          return obj;
+        }
+        default:
+          return null;
+      }
+    }
+
+    function buildRequiredBodyPrefill(schema) {
+      if (!schema || typeof schema !== "object") return "";
+      const prefillValue = schemaDefaultValue(schema);
+      if (
+        prefillValue &&
+        typeof prefillValue === "object" &&
+        !Array.isArray(prefillValue) &&
+        Object.keys(prefillValue).length === 0
+      ) {
+        return "";
+      }
+      try {
+        return JSON.stringify(prefillValue, null, 2);
+      } catch {
+        return "";
+      }
+    }
+
+    function hasMeaningfulRequestBodySchema(schema) {
+      if (!schema || typeof schema !== "object") return false;
+      if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) return true;
+      if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) return true;
+      if (Array.isArray(schema.allOf) && schema.allOf.length > 0) return true;
+      if (schema.type && schema.type !== "object") return true;
+      if (schema.additionalProperties !== undefined) return true;
+      if (Array.isArray(schema.required) && schema.required.length > 0) return true;
+      if (schema.properties && typeof schema.properties === "object") {
+        return Object.keys(schema.properties).length > 0;
+      }
+      return false;
+    }
+
+    function renderSidebar() {
+      const nav = document.getElementById("sidebar-nav");
+      const groups = new Map();
+      const query = sidebarSearchQuery.trim().toLowerCase();
+      const visibleOps = query
+        ? operations.filter((op) => {
+            const haystack = [
+              op.name,
+              op.path,
+              op.method,
+              op.tag,
+            ]
+              .join(" ")
+              .toLowerCase();
+            return haystack.includes(query);
+          })
+        : operations;
+
+      for (const op of visibleOps) {
+        if (!groups.has(op.tag)) groups.set(op.tag, []);
+        groups.get(op.tag).push(op);
+      }
+      nav.innerHTML = "";
+      if (visibleOps.length === 0) {
+        nav.innerHTML =
+          '<p class="px-2 text-xs opacity-60">No routes match your search.</p>';
+        return;
+      }
+      for (const [tag, ops] of groups.entries()) {
+        ops.sort((a, b) => {
+          const byName = a.name.localeCompare(b.name, undefined, { sensitivity: "base" });
+          if (byName !== 0) return byName;
+
+          const byPath = a.path.localeCompare(b.path, undefined, { sensitivity: "base" });
+          if (byPath !== 0) return byPath;
+
+          return a.method.localeCompare(b.method, undefined, { sensitivity: "base" });
+        });
+
+        const block = document.createElement("div");
+        block.innerHTML = '<h3 class="px-2 mb-2 font-semibold text-xs uppercase tracking-wider opacity-50"></h3><ul class="space-y-0.5"></ul>';
+        block.querySelector("h3").textContent = tag;
+        const list = block.querySelector("ul");
+        for (const op of ops) {
+          const li = document.createElement("li");
+          li.className = "enter-stagger";
+          li.style.setProperty("--stagger-delay", String(Math.min(list.children.length * 22, 180)) + "ms");
+          const a = document.createElement("a");
+          a.href = "#";
+          a.className = op === selected
+            ? "block px-2 py-1.5 rounded-md bg-brand-soft/70 dark:bg-brand/20 text-brand-deep dark:text-brand font-medium transition-colors"
+            : "block px-2 py-1.5 rounded-md hover:bg-black/5 dark:hover:bg-white/5 transition-colors";
+
+          const row = document.createElement("span");
+          row.className = "flex items-center gap-2";
+
+          const method = document.createElement("span");
+          method.className = "px-1.5 py-0.5 rounded text-[10px] font-mono font-semibold " + (methodBadge[op.method] || methodBadgeDefault);
+          method.textContent = op.method;
+
+          const name = document.createElement("span");
+          name.textContent = op.name;
+
+          row.appendChild(method);
+          row.appendChild(name);
+          a.appendChild(row);
+
+          a.onclick = (e) => {
+            e.preventDefault();
+            selected = op;
+            renderSidebar();
+            renderEndpoint();
+            if (window.innerWidth < 768) {
+              setMobileSidebarOpen(false);
+            }
+          };
+          li.appendChild(a);
+          list.appendChild(li);
+        }
+        nav.appendChild(block);
+      }
+    }
+
+    function renderParamSection(title, params) {
+      if (!params.length) return "";
+      let rows = "";
+      for (const p of params) {
+        const type = escapeHtml((p.schema && p.schema.type) || "unknown");
+        const name = escapeHtml(p.name || "");
+        rows += '<div class="py-2 flex justify-between border-b border-light-border/50 dark:border-dark-border/50"><div><code class="text-sm font-mono">' + name + '</code><span class="text-xs text-brand ml-2">' + (p.required ? "required" : "optional") + '</span></div><span class="text-xs font-mono opacity-60">' + type + '</span></div>';
+      }
+      return '<div><h3 class="text-sm font-semibold mb-3 flex items-center border-b border-light-border dark:border-dark-border pb-2">' + escapeHtml(title) + "</h3>" + rows + "</div>";
+    }
+
+    function getSchemaTypeLabel(schema) {
+      if (!schema || typeof schema !== "object") return "unknown";
+      if (Array.isArray(schema.type)) return schema.type.join(" | ");
+      if (schema.type) return String(schema.type);
+      if (schema.properties) return "object";
+      if (schema.items) return "array";
+      if (Array.isArray(schema.oneOf)) return "oneOf";
+      if (Array.isArray(schema.anyOf)) return "anyOf";
+      if (Array.isArray(schema.allOf)) return "allOf";
+      return "unknown";
+    }
+
+    function buildSchemaChildren(schema) {
+      if (!schema || typeof schema !== "object") return [];
+
+      const children = [];
+
+      if (schema.properties && typeof schema.properties === "object") {
+        const requiredSet = new Set(
+          Array.isArray(schema.required) ? schema.required : [],
+        );
+        for (const [name, childSchema] of Object.entries(schema.properties)) {
+          children.push({
+            name,
+            schema: childSchema || {},
+            required: requiredSet.has(name),
+          });
+        }
+      }
+
+      if (schema.items) {
+        children.push({
+          name: "items[]",
+          schema: schema.items,
+          required: true,
+        });
+      }
+
+      return children;
+    }
+
+    function renderSchemaFieldNode(field, depth) {
+      const schema = field.schema || {};
+      const name = escapeHtml(field.name || "field");
+      const requiredLabel = field.required ? "required" : "optional";
+      const type = escapeHtml(getSchemaTypeLabel(schema));
+      const children = buildSchemaChildren(schema);
+      const padding = depth * 14;
+
+      if (!children.length) {
+        return (
+          '<div class="py-2 border-b border-light-border/50 dark:border-dark-border/50" style="padding-left:' +
+          padding +
+          'px"><div class="flex justify-between"><div><code class="text-sm font-mono">' +
+          name +
+          '</code><span class="text-xs text-brand ml-2">' +
+          requiredLabel +
+          '</span></div><span class="text-xs font-mono opacity-60">' +
+          type +
+          "</span></div></div>"
+        );
+      }
+
+      let nested = "";
+      for (const child of children) {
+        nested += renderSchemaFieldNode(child, depth + 1);
+      }
+
+      return (
+        '<details class="border-b border-light-border/50 dark:border-dark-border/50" open>' +
+        '<summary class="list-none cursor-pointer py-2 flex justify-between items-center" style="padding-left:' +
+        padding +
+        'px"><div class="flex items-center gap-2"><span class="text-xs opacity-70">\u25BE</span><code class="text-sm font-mono">' +
+        name +
+        '</code><span class="text-xs text-brand">' +
+        requiredLabel +
+        '</span></div><span class="text-xs font-mono opacity-60">' +
+        type +
+        "</span></summary>" +
+        '<div class="pb-1">' +
+        nested +
+        "</div></details>"
+      );
+    }
+
+    function renderRequestBodySchemaSection(schema) {
+      if (!schema || typeof schema !== "object") return "";
+      const rootChildren = buildSchemaChildren(schema);
+      if (!rootChildren.length) return "";
+
+      let rows = "";
+      for (const child of rootChildren) {
+        rows += renderSchemaFieldNode(child, 0);
+      }
+
+      return (
+        '<div><h3 class="text-sm font-semibold mb-3 flex items-center border-b border-light-border dark:border-dark-border pb-2">Request Body</h3>' +
+        rows +
+        "</div>"
+      );
+    }
+
+    function renderResponseSchemasSection(responses) {
+      if (!responses || typeof responses !== "object") return "";
+
+      const statusCodes = Object.keys(responses).sort((a, b) => {
+        const aNum = Number(a);
+        const bNum = Number(b);
+        if (Number.isInteger(aNum) && Number.isInteger(bNum)) return aNum - bNum;
+        if (Number.isInteger(aNum)) return -1;
+        if (Number.isInteger(bNum)) return 1;
+        return a.localeCompare(b);
+      });
+
+      let sections = "";
+      for (const statusCode of statusCodes) {
+        const responseDef = responses[statusCode];
+        if (!responseDef || typeof responseDef !== "object") continue;
+
+        const jsonSchema =
+          responseDef.content &&
+          responseDef.content["application/json"] &&
+          responseDef.content["application/json"].schema;
+
+        if (!jsonSchema || typeof jsonSchema !== "object") continue;
+
+        const rootChildren = buildSchemaChildren(jsonSchema);
+        if (!rootChildren.length) continue;
+
+        let rows = "";
+        for (const child of rootChildren) {
+          rows += renderSchemaFieldNode(child, 0);
+        }
+
+        sections +=
+          '<div class="mb-4"><h4 class="text-xs font-mono uppercase tracking-wider opacity-70 mb-2">Status ' +
+          escapeHtml(statusCode) +
+          "</h4>" +
+          rows +
+          "</div>";
+      }
+
+      if (!sections) return "";
+
+      return (
+        '<div><h3 class="text-sm font-semibold mb-3 flex items-center border-b border-light-border dark:border-dark-border pb-2">Response Schemas</h3>' +
+        sections +
+        "</div>"
+      );
+    }
+
+    function renderTryItParameterInputs(pathParams, queryParams) {
+      const container = document.getElementById("request-param-inputs");
+      if (!container || !selected) return;
+
+      const values = getParameterValues(selected);
+      container.innerHTML = "";
+
+      const sections = [
+        { title: "Path Values", params: pathParams },
+        { title: "Query Values", params: queryParams },
+      ];
+
+      for (const section of sections) {
+        if (!section.params.length) continue;
+
+        const group = document.createElement("div");
+        group.className = "space-y-2";
+
+        const title = document.createElement("p");
+        title.className = "text-xs font-semibold uppercase tracking-wider opacity-60";
+        title.textContent = section.title;
+        group.appendChild(title);
+
+        for (const param of section.params) {
+          const field = document.createElement("div");
+          field.className = "space-y-1";
+
+          const label = document.createElement("label");
+          label.className = "text-xs opacity-80 flex items-center gap-2";
+
+          const labelName = document.createElement("span");
+          labelName.className = "font-mono";
+          labelName.textContent = param.name;
+
+          const required = document.createElement("span");
+          required.className = "text-[10px] text-brand";
+          required.textContent = param.required ? "required" : "optional";
+
+          label.appendChild(labelName);
+          label.appendChild(required);
+
+          const input = document.createElement("input");
+          input.type = "text";
+          input.value = values[param.name] || "";
+          input.placeholder =
+            section.title === "Path Values" ? param.name : "optional";
+          input.className =
+            "w-full text-sm px-3 py-2 rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg focus:outline-none focus:border-brand dark:focus:border-brand transition-colors font-mono";
+
+          input.addEventListener("input", () => {
+            values[param.name] = input.value;
+            updateRequestPreview();
+          });
+
+          field.appendChild(label);
+          field.appendChild(input);
+          group.appendChild(field);
+        }
+
+        container.appendChild(group);
+      }
+    }
+
+    function renderHeaderInputs() {
+      const container = document.getElementById("header-inputs");
+      if (!container) return;
+
+      container.innerHTML = "";
+      requestHeaders.forEach((entry, index) => {
+        const row = document.createElement("div");
+        row.className = "grid grid-cols-[1fr_1fr_auto] gap-2";
+
+        const keyInput = document.createElement("input");
+        keyInput.type = "text";
+        keyInput.value = entry.key || "";
+        keyInput.placeholder = "Header";
+        keyInput.className =
+          "w-full text-xs px-2.5 py-2 rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg focus:outline-none focus:border-brand dark:focus:border-brand transition-colors font-mono";
+        keyInput.addEventListener("input", () => {
+          entry.key = keyInput.value;
+          updateRequestPreview();
+        });
+
+        const valueInput = document.createElement("input");
+        valueInput.type = "text";
+        valueInput.value = entry.value || "";
+        valueInput.placeholder =
+          String(entry.key || "").toLowerCase() === "authorization"
+            ? "Bearer token"
+            : "Value";
+        valueInput.className =
+          "w-full text-xs px-2.5 py-2 rounded border border-light-border dark:border-dark-border bg-light-bg dark:bg-dark-bg focus:outline-none focus:border-brand dark:focus:border-brand transition-colors font-mono";
+        valueInput.addEventListener("input", () => {
+          entry.value = valueInput.value;
+          updateRequestPreview();
+        });
+
+        const removeButton = document.createElement("button");
+        removeButton.type = "button";
+        removeButton.className =
+          "p-1.5 rounded-full border border-light-border dark:border-dark-border bg-light-bg/90 dark:bg-dark-bg/90 opacity-90 hover:opacity-100 hover:border-brand/60 transition-colors";
+        removeButton.setAttribute("aria-label", "Remove Header");
+        removeButton.setAttribute("title", "Remove Header");
+        removeButton.innerHTML =
+          '<svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 12h12"></path></svg>';
+        removeButton.addEventListener("click", () => {
+          requestHeaders.splice(index, 1);
+          renderHeaderInputs();
+          updateRequestPreview();
+        });
+
+        row.appendChild(keyInput);
+        row.appendChild(valueInput);
+        row.appendChild(removeButton);
+        container.appendChild(row);
+      });
+    }
+
+    function hasHeaderName(headers, expectedName) {
+      const target = expectedName.toLowerCase();
+      return Object.keys(headers).some((key) => key.toLowerCase() === target);
+    }
+
+    function getRequestHeadersObject() {
+      const headers = {};
+      for (const entry of requestHeaders) {
+        const key = String(entry.key || "").trim();
+        const value = String(entry.value || "").trim();
+        if (!key || !value) continue;
+        headers[key] = value;
+      }
+      return headers;
+    }
+
+    function buildCurl(op, headers, body, requestPath) {
+      const url = window.location.origin + requestPath;
+      const lines = ['curl -X ' + op.method + ' "' + url + '"'];
+
+      for (const [name, value] of Object.entries(headers)) {
+        const safeName = String(name).replace(/"/g, '\\"');
+        const safeValue = String(value).replace(/"/g, '\\"');
+        lines.push('  -H "' + safeName + ": " + safeValue + '"');
+      }
+
+      if (body) {
+        lines.push("  -d '" + body.replace(/'/g, "'\\\\''") + "'");
+      }
+
+      return lines.join(" \\\\\\n");
+    }
+
+    function formatBodyJsonInput() {
+      const bodyInput = document.getElementById("body-input");
+      if (!bodyInput) return;
+      const current = bodyInput.value.trim();
+      if (!current) return;
+      try {
+        bodyInput.value = JSON.stringify(JSON.parse(current), null, 2);
+      } catch {}
+    }
+
+    function escapeHtml(value) {
+      return String(value)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    }
+
+    function toPrettyJson(value) {
+      const trimmed = (value || "").trim();
+      if (!trimmed) return null;
+      try {
+        return JSON.stringify(JSON.parse(trimmed), null, 2);
+      } catch {
+        return null;
+      }
+    }
+
+    function highlightJson(jsonText) {
+      const escaped = escapeHtml(jsonText);
+      return escaped.replace(
+        /("(\\\\u[a-zA-Z0-9]{4}|\\\\[^u]|[^\\\\"])*"(\\s*:)?|\\btrue\\b|\\bfalse\\b|\\bnull\\b|-?\\d+(?:\\.\\d+)?(?:[eE][+\\-]?\\d+)?)/g,
+        (match) => {
+          let cls = "json-number";
+          if (match.startsWith('"')) {
+            cls = match.endsWith(":") ? "json-key" : "json-string";
+          } else if (match === "true" || match === "false") {
+            cls = "json-boolean";
+          } else if (match === "null") {
+            cls = "json-null";
+          }
+          return '<span class="' + cls + '">' + match + "</span>";
+        },
+      );
+    }
+
+    function updateBodyJsonPresentation() {
+      const bodyInput = document.getElementById("body-input");
+      const highlight = document.getElementById("body-highlight");
+      const bodySection = document.getElementById("request-body-section");
+
+      if (!bodyInput || !highlight || !bodySection) return;
+      if (bodySection.classList.contains("hidden")) {
+        highlight.innerHTML = "";
+        return;
+      }
+
+      const raw = bodyInput.value || "";
+      if (!raw.trim()) {
+        const placeholder = bodyInput.getAttribute("placeholder") || "";
+        highlight.innerHTML = '<span class="opacity-40">' + escapeHtml(placeholder) + "</span>";
+        return;
+      }
+
+      const prettyJson = toPrettyJson(raw);
+      if (!prettyJson) {
+        highlight.innerHTML = escapeHtml(raw);
+        return;
+      }
+
+      highlight.innerHTML = highlightJson(raw);
+    }
+
+    function syncBodyEditorScroll() {
+      const bodyInput = document.getElementById("body-input");
+      const highlight = document.getElementById("body-highlight");
+      if (!bodyInput || !highlight) return;
+      highlight.scrollTop = bodyInput.scrollTop;
+      highlight.scrollLeft = bodyInput.scrollLeft;
+    }
+
+    function updateExpandEditorPresentation() {
+      const editor = document.getElementById("expand-editor");
+      const highlight = document.getElementById("expand-editor-highlight");
+      if (!editor || !highlight) return;
+      const raw = editor.value || "";
+      if (!raw.trim()) {
+        highlight.innerHTML = "";
+        return;
+      }
+      const prettyJson = toPrettyJson(raw);
+      highlight.innerHTML = prettyJson ? highlightJson(raw) : escapeHtml(raw);
+    }
+
+    function syncExpandEditorScroll() {
+      const editor = document.getElementById("expand-editor");
+      const highlight = document.getElementById("expand-editor-highlight");
+      if (!editor || !highlight) return;
+      highlight.scrollTop = editor.scrollTop;
+      highlight.scrollLeft = editor.scrollLeft;
+    }
+
+    function formatResponseText(responseText) {
+      const trimmed = (responseText || "").trim();
+      if (!trimmed) return { text: "(empty)", isJson: false };
+      try {
+        return {
+          text: JSON.stringify(JSON.parse(trimmed), null, 2),
+          isJson: true,
+        };
+      } catch {
+        return {
+          text: responseText,
+          isJson: false,
+        };
+      }
+    }
+
+    function setResponseContent(headerText, bodyText, isJson) {
+      const result = document.getElementById("result");
+      if (!result) return;
+      const fullText = String(headerText || "") + String(bodyText || "");
+      result.dataset.raw = fullText;
+      result.dataset.header = String(headerText || "");
+      result.dataset.body = String(bodyText || "");
+      result.dataset.isJson = isJson ? "true" : "false";
+      if (isJson) {
+        result.innerHTML = escapeHtml(String(headerText || "")) + highlightJson(String(bodyText || ""));
+      } else {
+        result.textContent = fullText;
+      }
+    }
+
+    function setSubmitLoading(isLoading) {
+      const sendButton = document.getElementById("send-btn");
+      const spinner = document.getElementById("send-btn-spinner");
+      const label = document.getElementById("send-btn-label");
+      if (!sendButton) return;
+
+      sendButton.disabled = isLoading;
+      sendButton.classList.toggle("opacity-80", isLoading);
+      sendButton.classList.toggle("cursor-wait", isLoading);
+      if (spinner) spinner.classList.toggle("hidden", !isLoading);
+      if (label) label.textContent = isLoading ? "Sending..." : "Submit";
+    }
+
+    function updateRequestPreview() {
+      if (!selected) return;
+
+      const { path, query } = getOperationParameterGroups(selected);
+      const values = getParameterValues(selected);
+      const requestPath = buildRequestPath(selected, path, query, values);
+      const bodyInput = document.getElementById("body-input");
+      const body = bodyInput ? bodyInput.value.trim() : "";
+      const headers = getRequestHeadersObject();
+      if (body && !hasHeaderName(headers, "Content-Type")) {
+        headers["Content-Type"] = "application/json";
+      }
+
+      document.getElementById("endpoint-path").textContent = requestPath;
+      document.getElementById("curl-code").textContent = buildCurl(
+        selected,
+        headers,
+        body,
+        requestPath,
+      );
+    }
+
+    function renderEndpoint() {
+      if (!selected) return;
+      const endpointCard = document.getElementById("endpoint-card");
+      if (endpointCard) {
+        endpointCard.classList.remove("enter-fade-up");
+        // Restart CSS animation for each operation switch
+        void endpointCard.offsetWidth;
+        endpointCard.classList.add("enter-fade-up");
+      }
+
+      const op = selected.operation || {};
+      const reqSchema = op.requestBody && op.requestBody.content && op.requestBody.content["application/json"] && op.requestBody.content["application/json"].schema;
+      const requestBodySection = document.getElementById("request-body-section");
+      const bodyInput = document.getElementById("body-input");
+      const expandBodyBtn = document.getElementById("expand-body-btn");
+      const supportsBody = hasMeaningfulRequestBodySchema(reqSchema);
+
+      if (requestBodySection) {
+        requestBodySection.classList.toggle("hidden", !supportsBody);
+      }
+      if (supportsBody && bodyInput) {
+        const existingDraft = getBodyDraft(selected);
+        if (typeof existingDraft === "string") {
+          bodyInput.value = existingDraft;
+        } else {
+          const prefill = buildRequiredBodyPrefill(reqSchema);
+          bodyInput.value = prefill;
+          setBodyDraft(selected, prefill);
+        }
+      } else if (!supportsBody && bodyInput) {
+        bodyInput.value = "";
+      }
+      if (expandBodyBtn) {
+        expandBodyBtn.disabled = !supportsBody;
+      }
+      setResponseContent("", "", false);
+
+      document.getElementById("tag-title").textContent = selected.tag;
+      document.getElementById("tag-description").textContent = op.description || "Interactive API documentation.";
+      const methodNode = document.getElementById("endpoint-method");
+      methodNode.textContent = selected.method;
+      methodNode.className = "px-2.5 py-0.5 rounded-full text-xs font-mono font-medium " + (methodBadge[selected.method] || methodBadgeDefault);
+      document.getElementById("endpoint-title").textContent = selected.name;
+      document.getElementById("endpoint-path").textContent = selected.path;
+
+      const { all: params, query, path, headers } =
+        getOperationParameterGroups(selected);
+
+      let html = "";
+      html += renderParamSection("Path Parameters", path);
+      html += renderParamSection("Query Parameters", query);
+      html += renderParamSection("Header Parameters", headers);
+
+      html += renderRequestBodySchemaSection(reqSchema);
+      html += renderResponseSchemasSection(op.responses);
+      document.getElementById("params-column").innerHTML = html || '<div class="text-sm opacity-70">No parameters</div>';
+      renderTryItParameterInputs(path, query);
+      renderHeaderInputs();
+      updateRequestPreview();
+      updateBodyJsonPresentation();
+      syncBodyEditorScroll();
+    }
+
+    document.getElementById("copy-curl").addEventListener("click", async () => {
+      try { await navigator.clipboard.writeText(document.getElementById("curl-code").textContent || ""); } catch {}
+    });
+    document.getElementById("sidebar-search").addEventListener("input", (event) => {
+      sidebarSearchQuery = event.currentTarget.value || "";
+      renderSidebar();
+    });
+
+    document.getElementById("send-btn").addEventListener("click", async () => {
+      if (!selected) return;
+      const { path, query } = getOperationParameterGroups(selected);
+      const values = getParameterValues(selected);
+      const missingPathParams = path.filter((param) => {
+        if (param.required === false) return false;
+        const value = values[param.name];
+        return value === undefined || value === null || String(value).trim() === "";
+      });
+
+      if (missingPathParams.length > 0) {
+        setResponseContent(
+          "",
+          "Missing required path parameter(s): " +
+            missingPathParams.map((param) => param.name).join(", "),
+          false,
+        );
+        return;
+      }
+
+      const requestPath = buildRequestPath(selected, path, query, values);
+      formatBodyJsonInput();
+      updateBodyJsonPresentation();
+      const op = selected.operation || {};
+      const reqSchema = op.requestBody && op.requestBody.content && op.requestBody.content["application/json"] && op.requestBody.content["application/json"].schema;
+      const supportsBody = hasMeaningfulRequestBodySchema(reqSchema);
+      const bodyInput = document.getElementById("body-input");
+      const body =
+        supportsBody && bodyInput ? bodyInput.value.trim() : "";
+      const headers = getRequestHeadersObject();
+      if (body && !hasHeaderName(headers, "Content-Type")) {
+        headers["Content-Type"] = "application/json";
+      }
+
+      setSubmitLoading(true);
+      try {
+        const requestStart = performance.now();
+        const response = await fetch(requestPath, { method: selected.method, headers, body: body || undefined });
+        const text = await response.text();
+        const responseTimeMs = Math.round(performance.now() - requestStart);
+        const contentType = response.headers.get("content-type") || "unknown";
+        const formattedResponse = formatResponseText(text);
+        const headerText =
+          "Status: " + response.status + " " + response.statusText + "\\n" +
+          "Content-Type: " + contentType + "\\n" +
+          "Response Time: " + responseTimeMs + " ms\\n\\n";
+        setResponseContent(
+          headerText,
+          formattedResponse.text,
+          formattedResponse.isJson,
+        );
+      } catch (error) {
+        setResponseContent("", "Request failed: " + String(error), false);
+      } finally {
+        setSubmitLoading(false);
+      }
+    });
+
+    function openExpandModal(mode) {
+      const modal = document.getElementById("expand-modal");
+      const title = document.getElementById("expand-modal-title");
+      const editorShell = document.getElementById("expand-editor-shell");
+      const editor = document.getElementById("expand-editor");
+      const viewer = document.getElementById("expand-viewer");
+      const apply = document.getElementById("expand-apply");
+      const bodyInput = document.getElementById("body-input");
+      const result = document.getElementById("result");
+      if (!modal || !title || !editorShell || !editor || !viewer || !apply) return;
+
+      expandModalMode = mode;
+      modal.classList.remove("hidden");
+      modal.classList.add("flex");
+
+      if (mode === "body") {
+        title.textContent = "Request Body";
+        editorShell.classList.remove("hidden");
+        viewer.classList.add("hidden");
+        apply.classList.remove("hidden");
+        editor.value = bodyInput ? bodyInput.value : "";
+        updateExpandEditorPresentation();
+        syncExpandEditorScroll();
+      } else {
+        title.textContent = "Response";
+        viewer.classList.remove("hidden");
+        editorShell.classList.add("hidden");
+        apply.classList.add("hidden");
+        const hasResponse = Boolean(result && result.dataset && result.dataset.raw);
+        if (!hasResponse) {
+          viewer.textContent = "(empty response yet)";
+          return;
+        }
+
+        const header = result.dataset.header || "";
+        const body = result.dataset.body || "";
+        const isJson = result.dataset.isJson === "true";
+        if (isJson) {
+          viewer.innerHTML = escapeHtml(header) + highlightJson(body);
+        } else {
+          viewer.textContent = result.dataset.raw || "(empty response yet)";
+        }
+      }
+    }
+
+    function closeExpandModal() {
+      const modal = document.getElementById("expand-modal");
+      if (!modal) return;
+      modal.classList.add("hidden");
+      modal.classList.remove("flex");
+      expandModalMode = null;
+    }
+
+    document.getElementById("add-header-btn").addEventListener("click", () => {
+      requestHeaders.push({ key: "", value: "" });
+      renderHeaderInputs();
+      updateRequestPreview();
+    });
+    document.getElementById("body-input").addEventListener("input", () => {
+      if (selected) {
+        setBodyDraft(selected, document.getElementById("body-input").value);
+      }
+      updateRequestPreview();
+      updateBodyJsonPresentation();
+      syncBodyEditorScroll();
+    });
+    document.getElementById("body-input").addEventListener("scroll", () => {
+      syncBodyEditorScroll();
+    });
+    document.getElementById("body-input").addEventListener("keydown", (event) => {
+      if (event.key !== "Tab") return;
+      event.preventDefault();
+      const input = event.currentTarget;
+      const start = input.selectionStart;
+      const end = input.selectionEnd;
+      const value = input.value;
+      const tab = "  ";
+      input.value = value.slice(0, start) + tab + value.slice(end);
+      input.selectionStart = input.selectionEnd = start + tab.length;
+      if (selected) {
+        setBodyDraft(selected, input.value);
+      }
+      updateRequestPreview();
+      updateBodyJsonPresentation();
+      syncBodyEditorScroll();
+    });
+    document.getElementById("body-input").addEventListener("blur", () => {
+      formatBodyJsonInput();
+      if (selected) {
+        setBodyDraft(selected, document.getElementById("body-input").value);
+      }
+      updateRequestPreview();
+      updateBodyJsonPresentation();
+      syncBodyEditorScroll();
+    });
+    document.getElementById("expand-editor").addEventListener("input", () => {
+      updateExpandEditorPresentation();
+      syncExpandEditorScroll();
+    });
+    document.getElementById("expand-editor").addEventListener("scroll", () => {
+      syncExpandEditorScroll();
+    });
+    document.getElementById("expand-editor").addEventListener("keydown", (event) => {
+      if (event.key !== "Tab") return;
+      event.preventDefault();
+      const editor = event.currentTarget;
+      const start = editor.selectionStart;
+      const end = editor.selectionEnd;
+      const value = editor.value;
+      const tab = "  ";
+      editor.value = value.slice(0, start) + tab + value.slice(end);
+      editor.selectionStart = editor.selectionEnd = start + tab.length;
+      updateExpandEditorPresentation();
+      syncExpandEditorScroll();
+    });
+    document.getElementById("expand-editor").addEventListener("blur", () => {
+      const editor = document.getElementById("expand-editor");
+      const current = editor.value.trim();
+      if (current) {
+        try {
+          editor.value = JSON.stringify(JSON.parse(current), null, 2);
+        } catch {}
+      }
+      updateExpandEditorPresentation();
+      syncExpandEditorScroll();
+    });
+    document.getElementById("expand-body-btn").addEventListener("click", () => {
+      openExpandModal("body");
+    });
+    document.getElementById("expand-response-btn").addEventListener("click", () => {
+      openExpandModal("response");
+    });
+    document.getElementById("expand-close").addEventListener("click", closeExpandModal);
+    document.getElementById("expand-apply").addEventListener("click", () => {
+      if (expandModalMode !== "body") {
+        closeExpandModal();
+        return;
+      }
+
+      const editor = document.getElementById("expand-editor");
+      const bodyInput = document.getElementById("body-input");
+      if (editor && bodyInput) {
+        bodyInput.value = editor.value;
+        formatBodyJsonInput();
+        if (selected) {
+          setBodyDraft(selected, bodyInput.value);
+        }
+        updateRequestPreview();
+        updateBodyJsonPresentation();
+        syncBodyEditorScroll();
+      }
+      closeExpandModal();
+    });
+    document.getElementById("expand-modal").addEventListener("click", (event) => {
+      if (event.target === event.currentTarget) {
+        closeExpandModal();
+      }
+    });
+    document.getElementById("sidebar-open").addEventListener("click", () => {
+      setMobileSidebarOpen(true);
+    });
+    document.getElementById("sidebar-close").addEventListener("click", () => {
+      setMobileSidebarOpen(false);
+    });
+    document.getElementById("mobile-backdrop").addEventListener("click", () => {
+      setMobileSidebarOpen(false);
+    });
+    window.addEventListener("resize", () => {
+      if (window.innerWidth >= 768 && isMobileSidebarOpen) {
+        setMobileSidebarOpen(false);
+      }
+    });
+    document.addEventListener("keydown", (event) => {
+      if (event.key === "Escape") {
+        if (isMobileSidebarOpen) {
+          setMobileSidebarOpen(false);
+        }
+        closeExpandModal();
+      }
+    });
+
+    const themeToggleBtn = document.getElementById('theme-toggle');
+    const htmlElement = document.documentElement;
+    themeToggleBtn.addEventListener('click', () => {
+      htmlElement.classList.toggle('dark');
+      if (htmlElement.classList.contains('dark')) {
+        localStorage.setItem('theme', 'dark');
+      } else {
+        localStorage.setItem('theme', 'light');
+      }
+    });
+    window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', e => {
+      if (!('theme' in localStorage)) {
+        if (e.matches) htmlElement.classList.add('dark');
+        else htmlElement.classList.remove('dark');
+      }
+    });
+
+    setMobileSidebarOpen(false);
+    renderSidebar();
+    renderEndpoint();
+  </script>
+</body>
+</html>`}function W(e){let t=e?.["~standard"],d=t?.jsonSchema;return!!t&&typeof t==="object"&&t.version===1&&!!d&&typeof d.input==="function"&&typeof d.output==="function"}function xe(e){let t=0,d=[];return{openapiPath:e.split("/").map((r)=>{let o=/^:([A-Za-z0-9_]+)\+$/.exec(r);if(o?.[1])return d.push(o[1]),`{${o[1]}}`;let i=/^:([A-Za-z0-9_]+)$/.exec(r);if(i?.[1])return d.push(i[1]),`{${i[1]}}`;if(r==="*"){t+=1;let a=t===1?"wildcard":`wildcard${t}`;return d.push(a),`{${a}}`}return r}).join("/"),pathParamNames:d}}function Fe(e){return xe(e).openapiPath}function ze(e,t){return`${e.toLowerCase()}_${t}`.replace(/[:{}]/g,"").replace(/[^A-Za-z0-9_]+/g,"_").replace(/^_+|_+$/g,"")||`${e.toLowerCase()}_operation`}function Ge(e){let t=e.split("/").filter(Boolean);for(let d of t)if(!d.startsWith(":")&&d!=="*")return d.toLowerCase();return"default"}function Ve(e){return xe(e).pathParamNames}function Qe(e,t){let d=new Set((e.parameters||[]).filter((n)=>n.in==="path").map((n)=>String(n.name)));for(let n of Ve(t)){if(d.has(n))continue;(e.parameters||=[]).push({name:n,in:"path",required:!0,schema:{type:"string"}})}}function Ye(e){let t=Number(e);if(!Number.isInteger(t))return!1;return t>=100&&t<200||t===204||t===205||t===304}function Xe(e){if(e==="204")return"No Content";if(e==="205")return"Reset Content";if(e==="304")return"Not Modified";let t=Number(e);if(Number.isInteger(t)&&t>=100&&t<200)return"Informational";return"OK"}function We(e,t,d,n){if(!W(t)){let r=U(t);return Y(r)?null:r}try{return t["~standard"].jsonSchema.input({target:d})}catch(r){let o=ge(t,"input",d,r,e,void 0,n);if(o)return o;n.push(`[OpenAPI] Failed input schema conversion for ${e}: ${r instanceof Error?r.message:String(r)}. Falling back to a permissive JSON Schema.`);let i=U(t);return Y(i)?null:i}}function he(e,t,d,n,r){if(!W(d)){let o=U(d);return Y(o)?null:o}try{return d["~standard"].jsonSchema.output({target:n})}catch(o){let i=ge(d,"output",n,o,e,t,r);if(i)return i;return r.push(`[OpenAPI] Failed output schema conversion for ${e} (${t}): ${o instanceof Error?o.message:String(o)}. Falling back to a permissive JSON Schema.`),U(d)}}function y(e){return!!e&&typeof e==="object"&&!Array.isArray(e)}function Y(e){return y(e)&&Object.keys(e).length===0}function ge(e,t,d,n,r,o,i){if(!W(e))return null;let a=n instanceof Error?n.message:String(n);if(!(d==="openapi-3.0"&&a.includes("target 'openapi-3.0' is not supported")&&a.includes("draft-2020-12")&&a.includes("draft-07")))return null;try{let c=e["~standard"].jsonSchema[t]({target:"draft-07"});return i.push(t==="input"?`[OpenAPI] ${r} converter does not support openapi-3.0 target; using draft-07 conversion output.`:`[OpenAPI] ${r} (${o}) converter does not support openapi-3.0 target; using draft-07 conversion output.`),c}catch{return null}}function K(e){if(!e||typeof e!=="object")return null;let t=e;if(y(t._def))return t._def;if(y(t._zod)&&y(t._zod.def))return t._zod.def;if(t.kind==="schema"&&typeof t.type==="string")return t;return null}function ke(e){if(!e)return null;let t=e.typeName;if(typeof t==="string")return t;let d=e.type;if(typeof d==="string")return d;return null}function X(e){let t=["innerType","schema","type","out","in","left","right","wrapped","element"];for(let d of t)if(d in e)return e[d];return}function Ke(e,t){for(let d of t){let n=e[d];if(n&&typeof n==="object"&&!Array.isArray(n))return n}return}function Ze(e){if(!e)return!1;let t=e.toLowerCase();return t.includes("optional")||t.includes("default")||t.includes("catch")}function qe(e){let t=e,d=!1,n=0;while(n<8){n+=1;let r=K(t),o=ke(r);if(!r||!Ze(o))break;d=!0;let i=X(r);if(!i)break;t=i}return{schema:t,optional:d}}function et(e){let t=e.entries;if(y(t))return t;let d=e.shape;if(typeof d==="function")try{let n=d();return y(n)?n:{}}catch{return{}}return y(d)?d:{}}function ye(e){let t=e.values;if(Array.isArray(t))return t;if(t&&typeof t==="object")return Object.values(t);let d=e.entries;if(d&&typeof d==="object")return Object.values(d);let n=e.enum;if(n&&typeof n==="object")return Object.values(n);let r=e.options;if(Array.isArray(r))return r.map((o)=>{if(o&&typeof o==="object"&&"unit"in o)return o.unit;return o}).filter((o)=>o!==void 0);return[]}function tt(e){let t=e.toLowerCase();if(t.includes("string"))return{type:"string"};if(t.includes("number"))return{type:"number"};if(t.includes("boolean"))return{type:"boolean"};if(t.includes("bigint"))return{type:"string"};if(t==="null"||t.includes("zodnull"))return{type:"null"};if(t.includes("any")||t.includes("unknown")||t.includes("never"))return{};if(t.includes("date"))return{type:"string",format:"date-time"};if(t.includes("custom"))return{type:"object",additionalProperties:!0};return null}function g(e,t=new WeakSet){if(!e||typeof e!=="object")return{};if(t.has(e))return{};t.add(e);let d=K(e),n=ke(d);if(!d||!n)return{};let r=tt(n);if(r)return r;let o=n.toLowerCase();if(o.includes("object")){let a=et(d),s={},c=[];for(let[b,p]of Object.entries(a)){let x=qe(p);if(s[b]=g(x.schema,t),!x.optional)c.push(b)}let m={type:"object",properties:s,additionalProperties:!0};if(c.length>0)m.required=c;return m}if(o.includes("array")){let a=Ke(d,["element","items","innerType","type"])??{};return{type:"array",items:g(a,t)}}if(o.includes("record")){let a=d.valueType??d.valueSchema;return{type:"object",additionalProperties:a?g(a,t):!0}}if(o.includes("tuple")){let s=(Array.isArray(d.items)?d.items:[]).map((c)=>g(c,t));return{type:"array",prefixItems:s,minItems:s.length,maxItems:s.length}}if(o.includes("union")){let a=d.options??d.schemas??[];if(!Array.isArray(a)||a.length===0)return{};return{anyOf:a.map((s)=>g(s,t))}}if(o.includes("intersection")){let{left:a,right:s}=d;if(!a||!s)return{};return{allOf:[g(a,t),g(s,t)]}}if(o.includes("enum")){let a=ye(d);if(a.length>0){let s=a.every((b)=>typeof b==="string"),c=a.every((b)=>typeof b==="number"),m=a.every((b)=>typeof b==="boolean");if(s)return{type:"string",enum:a};if(c)return{type:"number",enum:a};if(m)return{type:"boolean",enum:a};return{enum:a}}return{}}if(o.includes("picklist")){let a=ye(d);if(a.length>0){if(a.every((c)=>typeof c==="string"))return{type:"string",enum:a};return{enum:a}}return{}}if(o.includes("literal")){let a=d.value;if(a===void 0)return{};let s=a===null?"null":typeof a;if(s==="string"||s==="number"||s==="boolean"||s==="null")return{type:s,const:a};return{const:a}}if(o.includes("nullable")){let a=X(d);if(!a)return{};return{anyOf:[g(a,t),{type:"null"}]}}if(o.includes("lazy")){let a=d.getter;if(typeof a!=="function")return{};try{return g(a(),t)}catch{return{}}}let i=X(d);if(i)return g(i,t);return{}}function U(e){if(!K(e))return{};return g(e)}function dt(e,t){if(!y(t))return;if(t.type!=="object"||!y(t.properties)){e.requestBody={required:!0,content:{"application/json":{schema:t}}};return}let d=new Set(Array.isArray(t.required)?t.required:[]),n=t.properties,r=Array.isArray(e.parameters)?e.parameters:[],o=[{key:"params",in:"path"},{key:"query",in:"query"},{key:"headers",in:"header"},{key:"cookies",in:"cookie"}];for(let a of o){let s=n[a.key];if(!y(s))continue;if(s.type!=="object"||!y(s.properties))continue;let c=new Set(Array.isArray(s.required)?s.required:[]);for(let[m,b]of Object.entries(s.properties))r.push({name:m,in:a.in,required:a.in==="path"?!0:c.has(m),schema:y(b)?b:{}})}if(r.length>0){let a=new Map;for(let s of r)a.set(`${s.in}:${s.name}`,s);e.parameters=[...a.values()]}let i=n.body;if(i)e.requestBody={required:d.has("body"),content:{"application/json":{schema:y(i)?i:{}}}}}function nt(e,t,d,n,r){let o=d.output;if(!o){e.responses={200:{description:"OK"}};return}let i={};if(typeof o==="object"&&o!==null&&"~standard"in o){let a=he(t,"200",o,n,r);if(a)i["200"]={description:"OK",content:{"application/json":{schema:a}}};else i["200"]={description:"OK"}}else for(let[a,s]of Object.entries(o)){let c=String(a),m=he(t,c,s,n,r),b=Xe(c);if(m&&!Ye(c))i[c]={description:b,content:{"application/json":{schema:m}}};else i[c]={description:b}}if(Object.keys(i).length===0)i["200"]={description:"OK"};e.responses=i}function Ee(e,t){let d=[],n={};for(let i of e){if(i.options.expose===!1)continue;if(!i.method||!i.path)continue;let a=i.method.toLowerCase();if(a==="options")continue;let s=Fe(i.path),c={operationId:ze(a,s),tags:[i.options.schema?.tag||Ge(i.path)]},m=We(i.path,i.options.schema?.input,t.target,d);if(m)dt(c,m);Qe(c,i.path),nt(c,i.path,i.options.schema||{},t.target,d),n[s]||={},n[s][a]=c}return{document:{openapi:t.target==="openapi-3.0"?"3.0.3":"3.1.0",info:{title:t.info?.title||"Vector API",version:t.info?.version||"1.0.0",...t.info?.description?{description:t.info.description}:{}},paths:n},warnings:d}}var Z="/_vector/openapi/tailwindcdn.js",q="/_vector/openapi/logo_dark.svg",ee="/_vector/openapi/logo_white.svg",De="/_vector/openapi/favicon/apple-touch-icon.png",Ne="/_vector/openapi/favicon/favicon-32x32.png",Ae="/_vector/openapi/favicon/favicon-16x16.png",rt="/_vector/openapi/favicon/favicon.ico",je="/_vector/openapi/favicon/site.webmanifest",ot="/_vector/openapi/favicon/android-chrome-192x192.png",at="/_vector/openapi/favicon/android-chrome-512x512.png",it=["../openapi/assets/tailwindcdn.js","../src/openapi/assets/tailwindcdn.js","../../src/openapi/assets/tailwindcdn.js"],st=["../openapi/assets/logo_dark.svg","../src/openapi/assets/logo_dark.svg","../../src/openapi/assets/logo_dark.svg"],lt=["../openapi/assets/logo_white.svg","../src/openapi/assets/logo_white.svg","../../src/openapi/assets/logo_white.svg"],ct=["src/openapi/assets/tailwindcdn.js","openapi/assets/tailwindcdn.js","dist/openapi/assets/tailwindcdn.js"],bt=["src/openapi/assets/logo_dark.svg","openapi/assets/logo_dark.svg","dist/openapi/assets/logo_dark.svg"],mt=["src/openapi/assets/logo_white.svg","openapi/assets/logo_white.svg","dist/openapi/assets/logo_white.svg"],w=["../openapi/assets/favicon","../src/openapi/assets/favicon","../../src/openapi/assets/favicon"],L=["src/openapi/assets/favicon","openapi/assets/favicon","dist/openapi/assets/favicon"],pt="/* OpenAPI docs runtime asset missing: tailwind disabled */";function h(e,t){return e.map((d)=>`${d}/${t}`)}function E(e,t){for(let n of e)try{let r=new URL(n,import.meta.url);if(ne.existsSync(r))return Bun.file(r)}catch{}let d=process.cwd();for(let n of t){let r=Le.join(d,n);if(ne.existsSync(r))return Bun.file(r)}return null}var ve=E(it,ct),Be=E(st,bt),Ie=E(lt,mt),ut=E(h(w,"apple-touch-icon.png"),h(L,"apple-touch-icon.png")),ft=E(h(w,"favicon-32x32.png"),h(L,"favicon-32x32.png")),ht=E(h(w,"favicon-16x16.png"),h(L,"favicon-16x16.png")),yt=E(h(w,"favicon.ico"),h(L,"favicon.ico")),xt=E(h(w,"site.webmanifest"),h(L,"site.webmanifest")),gt=E(h(w,"android-chrome-192x192.png"),h(L,"android-chrome-192x192.png")),kt=E(h(w,"android-chrome-512x512.png"),h(L,"android-chrome-512x512.png")),we=[{path:De,file:ut,contentType:"image/png",filename:"apple-touch-icon.png"},{path:Ne,file:ft,contentType:"image/png",filename:"favicon-32x32.png"},{path:Ae,file:ht,contentType:"image/png",filename:"favicon-16x16.png"},{path:rt,file:yt,contentType:"image/x-icon",filename:"favicon.ico"},{path:je,file:xt,contentType:"application/manifest+json; charset=utf-8",filename:"site.webmanifest"},{path:ot,file:gt,contentType:"image/png",filename:"android-chrome-192x192.png"},{path:at,file:kt,contentType:"image/png",filename:"android-chrome-512x512.png"}],te="public, max-age=0, must-revalidate",C="public, max-age=31536000, immutable",de="no-store";function Et(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function vt(e){let t="^";for(let d of e){if(d==="*"){t+=".*";continue}t+=Et(d)}return t+="$",new RegExp(t)}function Bt(e,t){if(!t.includes("*"))return e===t;return vt(t).test(e)}class re{server=null;router;config;openapiConfig;openapiDocCache=null;openapiDocsHtmlCache=null;openapiWarningsLogged=!1;openapiTailwindMissingLogged=!1;openapiLogoDarkMissingLogged=!1;openapiLogoWhiteMissingLogged=!1;corsHandler=null;corsHeadersEntries=null;constructor(e,t){if(this.router=e,this.config=t,this.openapiConfig=this.normalizeOpenAPIConfig(t.openapi,t.development),t.cors){let d=this.normalizeCorsOptions(t.cors),{preflight:n,corsify:r}=ue(d);if(this.corsHandler={preflight:n,corsify:r},typeof d.origin==="string"&&(d.origin!=="*"||!d.credentials)){let i={"access-control-allow-origin":d.origin,"access-control-allow-methods":d.allowMethods,"access-control-allow-headers":d.allowHeaders,"access-control-expose-headers":d.exposeHeaders,"access-control-max-age":String(d.maxAge)};if(d.credentials)i["access-control-allow-credentials"]="true";this.corsHeadersEntries=Object.entries(i)}this.router.setCorsHeaders(this.corsHeadersEntries),this.router.setCorsHandler(this.corsHeadersEntries?null:this.corsHandler.corsify)}}normalizeOpenAPIConfig(e,t){let n=t!==!1&&!0;if(e===!1)return{enabled:!1,path:"/openapi.json",target:"openapi-3.0",docs:{enabled:!1,path:"/docs"}};if(e===!0)return{enabled:!0,path:"/openapi.json",target:"openapi-3.0",docs:{enabled:!1,path:"/docs"}};let r=e||{},o=r.docs,i=typeof o==="boolean"?{enabled:o,path:"/docs",exposePaths:void 0}:{enabled:o?.enabled===!0,path:o?.path||"/docs",exposePaths:Array.isArray(o?.exposePaths)?o.exposePaths.map((a)=>typeof a==="string"?a.trim():"").filter((a)=>a.length>0):void 0};return{enabled:r.enabled??n,path:r.path||"/openapi.json",target:r.target||"openapi-3.0",docs:i,info:r.info}}isDocsReservedPath(e){return e===this.openapiConfig.path||this.openapiConfig.docs.enabled&&e===this.openapiConfig.docs.path}shouldLogOpenAPIConversionWarnings(){if(this.config.development===!1)return!1;let d=process.env.LOG_LEVEL;return typeof d==="string"&&d.toLowerCase()==="debug"}getOpenAPIDocument(){if(this.openapiDocCache)return this.openapiDocCache;let e=this.router.getRouteDefinitions().filter((d)=>!this.isDocsReservedPath(d.path)),t=Ee(e,{target:this.openapiConfig.target,info:this.openapiConfig.info});if(!this.openapiWarningsLogged&&t.warnings.length>0){if(this.shouldLogOpenAPIConversionWarnings())for(let d of t.warnings)console.warn(d);this.openapiWarningsLogged=!0}return this.openapiDocCache=t.document,this.openapiDocCache}getOpenAPIDocumentForDocs(){let e=this.openapiConfig.docs.exposePaths,t=this.getOpenAPIDocument();if(!Array.isArray(e)||e.length===0)return t;let d=t.paths&&typeof t.paths==="object"&&!Array.isArray(t.paths)?t.paths:{},n={};for(let[r,o]of Object.entries(d))if(e.some((i)=>Bt(r,i)))n[r]=o;return{...t,paths:n}}getOpenAPIDocsHtmlCacheEntry(){if(this.openapiDocsHtmlCache)return this.openapiDocsHtmlCache;let e=fe(this.getOpenAPIDocumentForDocs(),this.openapiConfig.path,Z,q,ee,De,Ne,Ae,je),t=Bun.gzipSync(e),d=`"${Bun.hash(e).toString(16)}"`;return this.openapiDocsHtmlCache={html:e,gzip:t,etag:d},this.openapiDocsHtmlCache}requestAcceptsGzip(e){let t=e.headers.get("accept-encoding");return Boolean(t&&/\bgzip\b/i.test(t))}validateReservedOpenAPIPaths(){if(!this.openapiConfig.enabled)return;let e=new Set([this.openapiConfig.path]);if(this.openapiConfig.docs.enabled){e.add(this.openapiConfig.docs.path),e.add(Z),e.add(q),e.add(ee);for(let r of we)e.add(r.path)}let t=this.router.getRouteDefinitions().filter((r)=>e.has(r.path)).map((r)=>`${r.method} ${r.path}`),d=Object.entries(this.router.getRouteTable()).filter(([r,o])=>e.has(r)&&o instanceof Response).map(([r])=>`STATIC ${r}`),n=[...t,...d];if(n.length>0)throw new Error(`OpenAPI reserved path conflict: ${n.join(", ")}. Change your route path(s) or reconfigure openapi.path/docs.path.`)}tryHandleOpenAPIRequest(e){if(!this.openapiConfig.enabled||e.method!=="GET")return null;let t=new URL(e.url).pathname;if(t===this.openapiConfig.path)return Response.json(this.getOpenAPIDocument());if(this.openapiConfig.docs.enabled&&t===this.openapiConfig.docs.path){let{html:d,gzip:n,etag:r}=this.getOpenAPIDocsHtmlCacheEntry();if(e.headers.get("if-none-match")===r)return new Response(null,{status:304,headers:{etag:r,"cache-control":te,vary:"accept-encoding"}});if(this.requestAcceptsGzip(e))return new Response(n,{status:200,headers:{"content-type":"text/html; charset=utf-8","content-encoding":"gzip",etag:r,"cache-control":te,vary:"accept-encoding"}});return new Response(d,{status:200,headers:{"content-type":"text/html; charset=utf-8",etag:r,"cache-control":te,vary:"accept-encoding"}})}if(this.openapiConfig.docs.enabled&&t===Z){if(!ve){if(!this.openapiTailwindMissingLogged)this.openapiTailwindMissingLogged=!0,console.warn('[OpenAPI] Missing docs runtime asset "tailwindcdn.js". Serving inline fallback script instead.');return new Response(pt,{status:200,headers:{"content-type":"application/javascript; charset=utf-8","cache-control":C}})}return new Response(ve,{status:200,headers:{"content-type":"application/javascript; charset=utf-8","cache-control":C}})}if(this.openapiConfig.docs.enabled&&t===q){if(!Be){if(!this.openapiLogoDarkMissingLogged)this.openapiLogoDarkMissingLogged=!0,console.warn('[OpenAPI] Missing docs runtime asset "logo_dark.svg".');return new Response("OpenAPI docs runtime asset missing: logo_dark.svg",{status:404,headers:{"content-type":"text/plain; charset=utf-8","cache-control":de}})}return new Response(Be,{status:200,headers:{"content-type":"image/svg+xml; charset=utf-8","cache-control":C}})}if(this.openapiConfig.docs.enabled&&t===ee){if(!Ie){if(!this.openapiLogoWhiteMissingLogged)this.openapiLogoWhiteMissingLogged=!0,console.warn('[OpenAPI] Missing docs runtime asset "logo_white.svg".');return new Response("OpenAPI docs runtime asset missing: logo_white.svg",{status:404,headers:{"content-type":"text/plain; charset=utf-8","cache-control":de}})}return new Response(Ie,{status:200,headers:{"content-type":"image/svg+xml; charset=utf-8","cache-control":C}})}if(this.openapiConfig.docs.enabled){let d=we.find((n)=>n.path===t);if(d){if(!d.file)return new Response(`OpenAPI docs runtime asset missing: ${d.filename}`,{status:404,headers:{"content-type":"text/plain; charset=utf-8","cache-control":de}});return new Response(d.file,{status:200,headers:{"content-type":d.contentType,"cache-control":C}})}}return null}normalizeCorsOptions(e){return{origin:e.origin||"*",credentials:e.credentials!==!1,allowHeaders:Array.isArray(e.allowHeaders)?e.allowHeaders.join(", "):e.allowHeaders||"Content-Type, Authorization",allowMethods:Array.isArray(e.allowMethods)?e.allowMethods.join(", "):e.allowMethods||"GET, POST, PUT, PATCH, DELETE, OPTIONS",exposeHeaders:Array.isArray(e.exposeHeaders)?e.exposeHeaders.join(", "):e.exposeHeaders||"Authorization",maxAge:e.maxAge||86400}}applyCors(e,t){if(this.corsHeadersEntries){for(let[d,n]of this.corsHeadersEntries)e.headers.set(d,n);return e}if(this.corsHandler&&t)return this.corsHandler.corsify(e,t);return e}async start(){let e=this.config.port??3000,t=this.config.hostname||"localhost";this.validateReservedOpenAPIPaths();let d=async(n)=>{try{if(this.corsHandler&&n.method==="OPTIONS")return this.corsHandler.preflight(n);let r=this.tryHandleOpenAPIRequest(n);if(r)return this.applyCors(r,n);return this.applyCors(H.NOT_FOUND.clone(),n)}catch(r){return console.error("Server error:",r),this.applyCors(new Response("Internal Server Error",{status:500}),n)}};try{if(this.server=Bun.serve({port:e,hostname:t,reusePort:this.config.reusePort!==!1,routes:this.router.getRouteTable(),fetch:d,idleTimeout:this.config.idleTimeout??60,error:(n,r)=>{return console.error("[ERROR] Server error:",n),this.applyCors(new Response("Internal Server Error",{status:500}),r)}}),!this.server||!this.server.port)throw new Error(`Failed to start server on ${t}:${e} - server object is invalid`);return this.server}catch(n){if(n.code==="EADDRINUSE"||n.message?.includes("address already in use"))n.message=`Port ${e} is already in use`,n.port=e;else if(n.code==="EACCES"||n.message?.includes("permission denied"))n.message=`Permission denied to bind to port ${e}`,n.port=e;else if(n.message?.includes("EADDRNOTAVAIL"))n.message=`Cannot bind to hostname ${t}`,n.hostname=t;throw n}}stop(){if(this.server)this.server.stop(),this.server=null,this.openapiDocCache=null,this.openapiDocsHtmlCache=null,this.openapiWarningsLogged=!1,console.log("Server stopped")}getServer(){return this.server}getPort(){return this.server?.port??this.config.port??3000}getHostname(){return this.server?.hostname||this.config.hostname||"localhost"}getUrl(){let e=this.getPort();return`http://${this.getHostname()}:${e}`}}class D{static instance;router;server=null;middlewareManager;authManager;cacheManager;config={};routeScanner=null;routeGenerator=null;_protectedHandler=null;_cacheHandler=null;shutdownPromise=null;constructor(){this.middlewareManager=new T,this.authManager=new J,this.cacheManager=new S,this.router=new M(this.middlewareManager,this.authManager,this.cacheManager)}static getInstance(){if(!D.instance)D.instance=new D;return D.instance}setProtectedHandler(e){if(this._protectedHandler=e,e){this.authManager.setProtectedHandler(e);return}this.authManager.clearProtectedHandler()}getProtectedHandler(){return this._protectedHandler}setCacheHandler(e){if(this._cacheHandler=e,e){this.cacheManager.setCacheHandler(e);return}this.cacheManager.clearCacheHandler()}getCacheHandler(){return this._cacheHandler}addRoute(e,t){this.router.route(e,t)}async startServer(e){this.config={...this.config,...e};let t={...this.config.defaults?.route};if(this.router.setRouteBooleanDefaults(t),this.router.setDevelopmentMode(this.config.development),this.middlewareManager.clear(),this.config.autoDiscover!==!1)this.router.clearRoutes();if(e?.before)this.middlewareManager.addBefore(...e.before);if(e?.finally)this.middlewareManager.addFinally(...e.finally);if(typeof this.config.startup==="function")await this.config.startup();if(this.config.autoDiscover!==!1)await this.discoverRoutes();return this.server=new re(this.router,this.config),await this.server.start()}async discoverRoutes(){let e=this.config.routesDir||"./routes",t=this.config.routeExcludePatterns;if(this.routeScanner=new O(e,t),!this.routeGenerator)this.routeGenerator=new z;try{let d=await this.routeScanner.scan();if(d.length>0){if(this.config.development)await this.routeGenerator.generate(d);for(let n of d)try{let o=await import(R(n.path)),i=n.name==="default"?o.default:o[n.name];if(i){if(this.isRouteDefinition(i))this.router.route(i.options,i.handler),this.logRouteLoaded(i.options);else if(this.isRouteEntry(i))this.router.addRoute(i),this.logRouteLoaded(i);else if(typeof i==="function")this.router.route(n.options,i),this.logRouteLoaded(n.options)}}catch(r){console.error(`Failed to load route ${n.name} from ${n.path}:`,r)}}}catch(d){if(d.code!=="ENOENT"&&d.code!=="ENOTDIR")console.error("Failed to discover routes:",d)}}async loadRoute(e){if(typeof e==="function"){let t=e();if(this.isRouteEntry(t))this.router.addRoute(t)}else if(e&&typeof e==="object"){for(let[,t]of Object.entries(e))if(typeof t==="function"){let d=t();if(this.isRouteEntry(d))this.router.addRoute(d)}}}isRouteEntry(e){if(!Array.isArray(e)||e.length<3)return!1;let[t,d,n,r]=e;return typeof t==="string"&&d instanceof RegExp&&Array.isArray(n)&&n.length>0&&n.every((o)=>typeof o==="function")&&(r===void 0||typeof r==="string")}isRouteDefinition(e){return e!==null&&typeof e==="object"&&"entry"in e&&"options"in e&&"handler"in e&&typeof e.handler==="function"}logRouteLoaded(e){}stop(){if(this.server)this.server.stop(),this.server=null}async shutdown(){if(this.shutdownPromise)return this.shutdownPromise;this.shutdownPromise=(async()=>{if(this.stop(),typeof this.config.shutdown==="function")await this.config.shutdown()})();try{await this.shutdownPromise}finally{this.shutdownPromise=null}}getServer(){return this.server}getRouter(){return this.router}getCacheManager(){return this.cacheManager}getAuthManager(){return this.authManager}static resetInstance(){D.instance=null}}var oe=D.getInstance;function Me(e,t){return{entry:{method:e.method.toUpperCase(),path:e.path},options:e,handler:t}}function It(e){let t=e??null;try{return JSON.stringify(t)}catch(d){if(d instanceof TypeError&&/\bbigint\b/i.test(d.message))return JSON.stringify(t,(n,r)=>typeof r==="bigint"?r.toString():r);throw d}}function l(e,t,d){let n={error:!0,message:t,statusCode:e,timestamp:new Date().toISOString()};return I(e,n,d)}var B={badRequest:(e="Bad Request",t)=>l(v.BAD_REQUEST,e,t),unauthorized:(e="Unauthorized",t)=>l(v.UNAUTHORIZED,e,t),paymentRequired:(e="Payment Required",t)=>l(402,e,t),forbidden:(e="Forbidden",t)=>l(v.FORBIDDEN,e,t),notFound:(e="Not Found",t)=>l(v.NOT_FOUND,e,t),methodNotAllowed:(e="Method Not Allowed",t)=>l(405,e,t),notAcceptable:(e="Not Acceptable",t)=>l(406,e,t),requestTimeout:(e="Request Timeout",t)=>l(408,e,t),conflict:(e="Conflict",t)=>l(v.CONFLICT,e,t),gone:(e="Gone",t)=>l(410,e,t),lengthRequired:(e="Length Required",t)=>l(411,e,t),preconditionFailed:(e="Precondition Failed",t)=>l(412,e,t),payloadTooLarge:(e="Payload Too Large",t)=>l(413,e,t),uriTooLong:(e="URI Too Long",t)=>l(414,e,t),unsupportedMediaType:(e="Unsupported Media Type",t)=>l(415,e,t),rangeNotSatisfiable:(e="Range Not Satisfiable",t)=>l(416,e,t),expectationFailed:(e="Expectation Failed",t)=>l(417,e,t),imATeapot:(e="I'm a teapot",t)=>l(418,e,t),misdirectedRequest:(e="Misdirected Request",t)=>l(421,e,t),unprocessableEntity:(e="Unprocessable Entity",t)=>l(v.UNPROCESSABLE_ENTITY,e,t),locked:(e="Locked",t)=>l(423,e,t),failedDependency:(e="Failed Dependency",t)=>l(424,e,t),tooEarly:(e="Too Early",t)=>l(425,e,t),upgradeRequired:(e="Upgrade Required",t)=>l(426,e,t),preconditionRequired:(e="Precondition Required",t)=>l(428,e,t),tooManyRequests:(e="Too Many Requests",t)=>l(429,e,t),requestHeaderFieldsTooLarge:(e="Request Header Fields Too Large",t)=>l(431,e,t),unavailableForLegalReasons:(e="Unavailable For Legal Reasons",t)=>l(451,e,t),internalServerError:(e="Internal Server Error",t)=>l(v.INTERNAL_SERVER_ERROR,e,t),notImplemented:(e="Not Implemented",t)=>l(501,e,t),badGateway:(e="Bad Gateway",t)=>l(502,e,t),serviceUnavailable:(e="Service Unavailable",t)=>l(503,e,t),gatewayTimeout:(e="Gateway Timeout",t)=>l(504,e,t),httpVersionNotSupported:(e="HTTP Version Not Supported",t)=>l(505,e,t),variantAlsoNegotiates:(e="Variant Also Negotiates",t)=>l(506,e,t),insufficientStorage:(e="Insufficient Storage",t)=>l(507,e,t),loopDetected:(e="Loop Detected",t)=>l(508,e,t),notExtended:(e="Not Extended",t)=>l(510,e,t),networkAuthenticationRequired:(e="Network Authentication Required",t)=>l(511,e,t),invalidArgument:(e="Invalid Argument",t)=>l(v.UNPROCESSABLE_ENTITY,e,t),rateLimitExceeded:(e="Rate Limit Exceeded",t)=>l(429,e,t),maintenance:(e="Service Under Maintenance",t)=>l(503,e,t),custom:(e,t,d)=>l(e,t,d)};function I(e,t,d=_.JSON){let n=d===_.JSON?It(t):t;return new Response(n,{status:e,headers:{"content-type":d}})}var Ce=require("fs"),$=require("path");class ae{configPath;config=null;configSource="default";constructor(e){let t=e||"vector.config.ts";this.configPath=$.isAbsolute(t)?t:$.resolve(process.cwd(),t)}async load(){if(Ce.existsSync(this.configPath))try{let t=await import(R(this.configPath));this.config=t.default||t,this.configSource="user"}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`[vector] Failed to load config from ${this.configPath}: ${t}`),console.error("[vector] Server is using default configuration. Fix your config file and restart."),this.config={}}else this.config={};return await this.buildLegacyConfig()}getConfigSource(){return this.configSource}async buildLegacyConfig(){let e={};if(this.config)e.port=this.config.port,e.hostname=this.config.hostname,e.reusePort=this.config.reusePort,e.development=this.config.development,e.routesDir=this.config.routesDir||"./routes",e.routeExcludePatterns=this.config.routeExcludePatterns,e.idleTimeout=this.config.idleTimeout,e.defaults=this.config.defaults,e.openapi=this.config.openapi,e.startup=this.config.startup,e.shutdown=this.config.shutdown;if(e.autoDiscover=!0,this.config?.cors)if(typeof this.config.cors==="boolean")e.cors=this.config.cors?{origin:"*",credentials:!0,allowHeaders:"Content-Type, Authorization",allowMethods:"GET, POST, PUT, PATCH, DELETE, OPTIONS",exposeHeaders:"Authorization",maxAge:86400}:void 0;else e.cors=this.config.cors;if(this.config?.before)e.before=this.config.before;if(this.config?.after)e.finally=this.config.after;return e}async loadAuthHandler(){return this.config?.auth||null}async loadCacheHandler(){return this.config?.cache||null}getConfig(){return this.config}}async function He(e={}){let t=new ae(e.configPath),d=await t.load(),n=t.getConfigSource(),r={...d};if(e.mutateConfig)r=await e.mutateConfig(r,{configSource:n});if(e.config)r={...r,...e.config};if(e.autoDiscover!==void 0)r.autoDiscover=e.autoDiscover;let o=oe(),i=e.protectedHandler!==void 0?e.protectedHandler:await t.loadAuthHandler(),a=e.cacheHandler!==void 0?e.cacheHandler:await t.loadCacheHandler();o.setProtectedHandler(i??null),o.setCacheHandler(a??null);let s=await o.startServer(r),c={...r,port:s.port??r.port??N.PORT,hostname:s.hostname||r.hostname||N.HOSTNAME,reusePort:r.reusePort!==!1,idleTimeout:r.idleTimeout??60};return{server:s,config:c,stop:()=>o.stop(),shutdown:()=>o.shutdown()}}})