@stacksjs/router 0.75.514 → 0.75.518

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/api-shape.js CHANGED
@@ -1 +1 @@
1
- export const JSON_CONTENT_TYPE=/^\s*application\/(?:json|[^\s;]+\+json)\s*(?:;|$)/i;export function isApiRequest(req){const headers=req.headers,contentType=headers.get("content-type")||"";if(contentType==="application/json"||JSON_CONTENT_TYPE.test(contentType))return!0;if(headers.get("sec-fetch-dest")==="document")return!1;if((headers.get("accept")||"").includes("text/html"))return!1;return!0}
1
+ export const JSON_CONTENT_TYPE=/^\s*application\/(?:json|[^\s;]+\+json)\s*(?:;|$)/i;export function isApiRequest(req){const headers=req.headers;const contentType=headers.get("content-type")||"";if(contentType==="application/json"||JSON_CONTENT_TYPE.test(contentType))return true;if(headers.get("sec-fetch-dest")==="document")return false;const accept=headers.get("accept")||"";if(accept.includes("text/html"))return false;return true}
package/dist/body.js CHANGED
@@ -1 +1 @@
1
- import{parseJsonText}from"./json";export class RequestBodyError extends Error{status;constructor(message,status){super(message);this.status=status;this.name="RequestBodyError"}}export async function readJsonBody(request,maxBytes=1048576,options={}){if(!Number.isSafeInteger(maxBytes)||maxBytes<1)throw RangeError("maxBytes must be a positive safe integer");if(request.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase()!=="application/json")throw new RequestBodyError("Content-Type must be application/json",415);const text=await readTextBody(request,maxBytes);try{return parseJsonText(text,options)}catch{throw new RequestBodyError("Send valid UTF-8 JSON",400)}}export async function readTextBody(request,maxBytes=1048576){if(!Number.isSafeInteger(maxBytes)||maxBytes<1)throw RangeError("maxBytes must be a positive safe integer");const declared=request.headers.get("content-length");if(declared&&(!/^\d+$/.test(declared)||Number(declared)>maxBytes))throw new RequestBodyError("Request body is too large",413);if(!request.body)throw new RequestBodyError("Send a request body",400);const reader=request.body.getReader();let bytes=new Uint8Array(Math.min(maxBytes,8192)),size=0;try{while(!0){const{done,value}=await reader.read();if(done)break;const offset=size;size+=value.byteLength;if(size>maxBytes){reader.cancel().catch(()=>{});throw new RequestBodyError("Request body is too large",413)}if(size>bytes.length){const grown=new Uint8Array(Math.min(maxBytes,Math.max(size,bytes.length*2)));grown.set(bytes);bytes=grown}bytes.set(value,offset)}}finally{reader.releaseLock()}try{return new TextDecoder("utf-8",{fatal:!0}).decode(bytes.subarray(0,size))}catch{throw new RequestBodyError("Send valid UTF-8",400)}}
1
+ import{parseJsonText}from"./json";export class RequestBodyError extends Error{status;constructor(message,status){super(message);this.status=status;this.name="RequestBodyError"}}export async function readJsonBody(request,maxBytes=1048576,options={}){if(!Number.isSafeInteger(maxBytes)||maxBytes<1)throw new RangeError("maxBytes must be a positive safe integer");if(request.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase()!=="application/json")throw new RequestBodyError("Content-Type must be application/json",415);const text=await readTextBody(request,maxBytes);try{return parseJsonText(text,options)}catch{throw new RequestBodyError("Send valid UTF-8 JSON",400)}}export async function readTextBody(request,maxBytes=1048576){if(!Number.isSafeInteger(maxBytes)||maxBytes<1)throw new RangeError("maxBytes must be a positive safe integer");const declared=request.headers.get("content-length");if(declared&&(!/^\d+$/.test(declared)||Number(declared)>maxBytes))throw new RequestBodyError("Request body is too large",413);if(!request.body)throw new RequestBodyError("Send a request body",400);const reader=request.body.getReader();let bytes=new Uint8Array(Math.min(maxBytes,8192));let size=0;try{while(true){const{done,value}=await reader.read();if(done)break;const offset=size;size+=value.byteLength;if(size>maxBytes){reader.cancel().catch(()=>{});throw new RequestBodyError("Request body is too large",413)}if(size>bytes.length){const grown=new Uint8Array(Math.min(maxBytes,Math.max(size,bytes.length*2)));grown.set(bytes);bytes=grown}bytes.set(value,offset)}}finally{reader.releaseLock()}try{return new TextDecoder("utf-8",{fatal:true}).decode(bytes.subarray(0,size))}catch{throw new RequestBodyError("Send valid UTF-8",400)}}
@@ -1 +1 @@
1
- export const DASHBOARD_ROUTE_GROUPS=["/ai","/api/analytics","/api/commerce","/api/data","/api/marketing","/api/monitoring","/api/notifications","/api/queries","/api/settings","/cms","/dashboard","/dashboard/cms","/dashboard/commerce","/deployments","/infrastructure","/jobs","/library","/models","/payments","/queue","/queues","/realtime","/releases","/voide"];export function resolveDashboardAccess(configured){const roles=new Map,unknown=[];if(!configured||typeof configured!=="object"||Array.isArray(configured))return{roles,unknown};const known=new Set(DASHBOARD_ROUTE_GROUPS);for(const[key,value]of Object.entries(configured)){const prefix=key.trim();if(!prefix)continue;if(!known.has(prefix)){unknown.push(prefix);continue}const names=(Array.isArray(value)?value:[value]).filter((name)=>typeof name==="string").map((name)=>name.trim()).filter((name)=>name.length>0);if(names.length>0)roles.set(prefix,names)}return{roles,unknown}}export function dashboardGroupMiddleware(prefix,access,base=["auth"]){const names=access.roles.get(prefix);return names?[...base,`role:${names.join(",")}`]:[...base]}export function describeUnknownDashboardGroups(unknown){if(unknown.length===0)return null;return`[dashboard] config/dashboard.ts \`access\` names ${unknown.length===1?"a route group":"route groups"} this framework does not register, so ${unknown.length===1?"it gates":"they gate"} nothing: ${[...unknown].sort().join(", ")}. Valid prefixes are ${DASHBOARD_ROUTE_GROUPS.join(", ")}.`}
1
+ export const DASHBOARD_ROUTE_GROUPS=["/ai","/api/analytics","/api/commerce","/api/data","/api/marketing","/api/monitoring","/api/notifications","/api/queries","/api/settings","/cms","/dashboard","/dashboard/cms","/dashboard/commerce","/deployments","/infrastructure","/jobs","/library","/models","/payments","/queue","/queues","/realtime","/releases","/voide"];export function resolveDashboardAccess(configured){const roles=new Map;const unknown=[];if(!configured||typeof configured!=="object"||Array.isArray(configured))return{roles,unknown};const known=new Set(DASHBOARD_ROUTE_GROUPS);for(const[key,value]of Object.entries(configured)){const prefix=key.trim();if(!prefix)continue;if(!known.has(prefix)){unknown.push(prefix);continue}const names=(Array.isArray(value)?value:[value]).filter((name)=>typeof name==="string").map((name)=>name.trim()).filter((name)=>name.length>0);if(names.length>0)roles.set(prefix,names)}return{roles,unknown}}export function dashboardGroupMiddleware(prefix,access,base=["auth"]){const names=access.roles.get(prefix);return names?[...base,`role:${names.join(",")}`]:[...base]}export function describeUnknownDashboardGroups(unknown){if(unknown.length===0)return null;return`[dashboard] config/dashboard.ts \`access\` names ${unknown.length===1?"a route group":"route groups"} this framework does not register, so ${unknown.length===1?"it gates":"they gate"} nothing: `+`${[...unknown].sort().join(", ")}. Valid prefixes are ${DASHBOARD_ROUTE_GROUPS.join(", ")}.`}
@@ -1 +1 @@
1
- let securityModuleLoad;function loadSecurityModule(){securityModuleLoad??=import("@stacksjs/security");return securityModuleLoad}export class EncryptedSessionStore{inner;opts;constructor(inner,opts={}){this.inner=inner;this.opts=opts}async set(sid,session,ttl){const envelope=await this.wrap(sid,session);await this.inner.set(sid,envelope,ttl)}async touch(sid,session,ttl){const envelope=await this.wrap(sid,session);if(this.inner.touch)await this.inner.touch(sid,envelope,ttl);else await this.inner.set(sid,envelope,ttl)}async get(sid){const stored=await this.inner.get(sid);if(!stored)return null;return this.unwrap(stored)}destroy(sid){return this.inner.destroy(sid)}async all(){const wrapped=await this.inner.all?.()??{},out={};for(const[sid,envelope]of Object.entries(wrapped)){const decrypted=await this.unwrap(envelope);if(decrypted)out[sid]=decrypted}return out}async length(){if(this.inner.length)return this.inner.length();return Object.keys(await this.all()).length}async clear(){if(this.inner.clear)return this.inner.clear();const sessions=await this.inner.all?.()??{};await Promise.all(Object.keys(sessions).map((sid)=>this.inner.destroy(sid)))}async wrap(sid,session){const{id,...rest}=session,{encrypt}=await loadSecurityModule(),ciphertext=await encrypt(JSON.stringify(rest),this.opts.appKey);return{_enc:!0,id:id??sid,data:ciphertext}}async unwrap(stored){if(!stored||typeof stored!=="object")return null;const candidate=stored;if(candidate._enc===!0&&typeof candidate.data==="string")try{const{decrypt}=await loadSecurityModule(),decrypted=await decrypt(candidate.data,this.opts.appKey),parsed=JSON.parse(decrypted);if(candidate.id!==void 0)parsed.id=candidate.id;return parsed}catch{return null}return candidate}}
1
+ let securityModuleLoad;function loadSecurityModule(){securityModuleLoad??=import("@stacksjs/security");return securityModuleLoad}export class EncryptedSessionStore{inner;opts;constructor(inner,opts={}){this.inner=inner;this.opts=opts}async set(sid,session,ttl){const envelope=await this.wrap(sid,session);await this.inner.set(sid,envelope,ttl)}async touch(sid,session,ttl){const envelope=await this.wrap(sid,session);if(this.inner.touch)await this.inner.touch(sid,envelope,ttl);else await this.inner.set(sid,envelope,ttl)}async get(sid){const stored=await this.inner.get(sid);if(!stored)return null;return this.unwrap(stored)}destroy(sid){return this.inner.destroy(sid)}async all(){const wrapped=await this.inner.all?.()??{};const out={};for(const[sid,envelope]of Object.entries(wrapped)){const decrypted=await this.unwrap(envelope);if(decrypted)out[sid]=decrypted}return out}async length(){if(this.inner.length)return this.inner.length();return Object.keys(await this.all()).length}async clear(){if(this.inner.clear)return this.inner.clear();const sessions=await this.inner.all?.()??{};await Promise.all(Object.keys(sessions).map((sid)=>this.inner.destroy(sid)))}async wrap(sid,session){const{id,...rest}=session;const{encrypt}=await loadSecurityModule();const ciphertext=await encrypt(JSON.stringify(rest),this.opts.appKey);return{_enc:true,id:id??sid,data:ciphertext}}async unwrap(stored){if(!stored||typeof stored!=="object")return null;const candidate=stored;if(candidate._enc===true&&typeof candidate.data==="string"){try{const{decrypt}=await loadSecurityModule();const decrypted=await decrypt(candidate.data,this.opts.appKey);const parsed=JSON.parse(decrypted);if(candidate.id!==undefined)parsed.id=candidate.id;return parsed}catch{return null}}return candidate}}
@@ -1,5 +1,5 @@
1
- import process from"node:process";import{log}from"@stacksjs/logging/runtime";import{isApiRequest}from"./api-shape";import{getRecentQueries,isDebugAllowed,registerQueryTracker}from"./query-tracking";import{applySecurityHeaders,createSecurityHeaders}from"./security-headers";export{clearTrackedQueries,getQueryShapeCounts,trackQuery}from"./query-tracking";registerQueryTracker();function buildErrorJson(opts){const body={error:opts.error,message:opts.message,status:opts.status,timestamp:new Date().toISOString()};if(opts.details)body.details=opts.details;return JSON.stringify(body)}function getErrorHeaders(contentType,extra){const headers=extra?new Headers(extra):createSecurityHeaders();if(extra)applySecurityHeaders(headers);headers.set("Content-Type",contentType);return headers}function getJsonHeaders(extra){return getErrorHeaders("application/json",extra)}function getJsonHeadersFull(){return getJsonHeaders()}function getErrorHandlerConfig(){return{appName:"Stacks",theme:"auto",showEnvironment:!0,showQueries:!0,showRequest:!0,enableCopyMarkdown:!0,snippetLines:8,basePaths:[process.cwd()]}}const SENSITIVE_PATTERNS=["password","secret","token","api_key","apikey","access_key","accesskey","private_key","privatekey","credit_card","creditcard","card_number","cardnumber","cvv","ssn","authorization","credential","aws_secret","aws_access","database_password","db_password","encryption_key","signing_key","bearer","session_id","sessionid","cookie"],MAX_SANITIZE_DEPTH=10,CIRCULAR_PLACEHOLDER="[Circular]";function sanitizeData(data,depth=0,seen=new WeakSet){if(!data||typeof data!=="object"||depth>=MAX_SANITIZE_DEPTH)return data;if(seen.has(data))return CIRCULAR_PLACEHOLDER;seen.add(data);if(Array.isArray(data))return data.map((item)=>sanitizeData(item,depth+1,seen));const sanitized={};for(const[key,value]of Object.entries(data)){const lowerKey=key.toLowerCase();if(SENSITIVE_PATTERNS.some((pattern)=>lowerKey.includes(pattern)))sanitized[key]="********";else if(typeof value==="object"&&value!==null)sanitized[key]=sanitizeData(value,depth+1,seen);else sanitized[key]=value}return sanitized}function getRequestBody(request){const req=request;if(req.jsonBody)return sanitizeData(req.jsonBody);if(req.formBody)return sanitizeData(req.formBody);return}async function getUserContext(request){const authed=request._authenticatedUser;if(authed)return{id:authed.id,email:authed.email,name:authed.name||authed.username};return}export async function createErrorResponse(error,request,options){const status=options?.status||500;log.debug(`[error] ${status} ${error.message}`);if(!isDebugAllowed()){if(isApiRequest(request)){const isClientError=status>=400&&status<500,errDetails=error.details;return new Response(buildErrorJson({error:isClientError?error.name||"Client Error":"Internal Server Error",message:isClientError?error.message:"An unexpected error occurred.",status,details:isClientError&&errDetails&&typeof errDetails==="object"?errDetails:void 0}),{status,headers:getJsonHeaders()})}const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(status),{status,headers:getErrorHeaders("text/html; charset=utf-8")})}try{const{createErrorHandler}=await import("@stacksjs/error-handling/error-page"),handler=createErrorHandler(getErrorHandlerConfig());handler.setFramework("Stacks","0.70.0");const requestBody=getRequestBody(request);if(requestBody){const url=new URL(request.url);handler.setRequest({method:request.method,url:request.url,headers:Object.fromEntries(request.headers.entries()),queryParams:Object.fromEntries(url.searchParams.entries()),body:requestBody})}else handler.setRequest(request);const userContext=await getUserContext(request);if(userContext)handler.setUser(userContext);if(options?.routingContext)handler.setRouting(options.routingContext);else if(options?.handlerPath)handler.setRouting({controller:options.handlerPath});for(const query of getRecentQueries())handler.addQuery(query.query,query.time,query.connection);if(isApiRequest(request)){const details={handler:options?.handlerPath};if(isDebugAllowed()){details.stack=error.stack?.split(`
2
- `).slice(0,10);details.queries=getRecentQueries().slice(-10)}return new Response(buildErrorJson({error:error.name||"Error",message:error.message,status,details}),{status,headers:getJsonHeadersFull()})}const corsOrigin=process.env.APP_URL?process.env.APP_URL.startsWith("http")?process.env.APP_URL:`https://${process.env.APP_URL}`:isDebugAllowed()?"*":request.headers.get("origin")??"null",html=await handler.render(error,status);return new Response(html,{status,headers:getErrorHeaders("text/html; charset=utf-8",{"Access-Control-Allow-Origin":corsOrigin})})}catch(renderError){console.error("[Error Handler] Failed to render error page:",renderError);const escapeHtml=(s)=>s.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");return new Response(`
1
+ import process from"node:process";import{log}from"@stacksjs/logging/runtime";import{isApiRequest}from"./api-shape";import{getRecentQueries,isDebugAllowed,registerQueryTracker}from"./query-tracking";import{applySecurityHeaders,createSecurityHeaders}from"./security-headers";export{clearTrackedQueries,getQueryShapeCounts,trackQuery}from"./query-tracking";registerQueryTracker();function buildErrorJson(opts){const body={error:opts.error,message:opts.message,status:opts.status,timestamp:new Date().toISOString()};if(opts.details)body.details=opts.details;return JSON.stringify(body)}function getErrorHeaders(contentType,extra){const headers=extra?new Headers(extra):createSecurityHeaders();if(extra)applySecurityHeaders(headers);headers.set("Content-Type",contentType);return headers}function getJsonHeaders(extra){return getErrorHeaders("application/json",extra)}function getJsonHeadersFull(){return getJsonHeaders()}function getErrorHandlerConfig(){return{appName:"Stacks",theme:"auto",showEnvironment:true,showQueries:true,showRequest:true,enableCopyMarkdown:true,snippetLines:8,basePaths:[process.cwd()]}}const SENSITIVE_PATTERNS=["password","secret","token","api_key","apikey","access_key","accesskey","private_key","privatekey","credit_card","creditcard","card_number","cardnumber","cvv","ssn","authorization","credential","aws_secret","aws_access","database_password","db_password","encryption_key","signing_key","bearer","session_id","sessionid","cookie"];const MAX_SANITIZE_DEPTH=10;const CIRCULAR_PLACEHOLDER="[Circular]";function sanitizeData(data,depth=0,seen=new WeakSet){if(!data||typeof data!=="object"||depth>=MAX_SANITIZE_DEPTH){return data}if(seen.has(data))return CIRCULAR_PLACEHOLDER;seen.add(data);if(Array.isArray(data)){return data.map((item)=>sanitizeData(item,depth+1,seen))}const sanitized={};for(const[key,value]of Object.entries(data)){const lowerKey=key.toLowerCase();if(SENSITIVE_PATTERNS.some((pattern)=>lowerKey.includes(pattern))){sanitized[key]="********"}else if(typeof value==="object"&&value!==null){sanitized[key]=sanitizeData(value,depth+1,seen)}else{sanitized[key]=value}}return sanitized}function getRequestBody(request){const req=request;if(req.jsonBody){return sanitizeData(req.jsonBody)}if(req.formBody){return sanitizeData(req.formBody)}return}async function getUserContext(request){const req=request;const authed=req._authenticatedUser;if(authed){return{id:authed.id,email:authed.email,name:authed.name||authed.username}}return}export async function createErrorResponse(error,request,options){const status=options?.status||500;const errorHeaders=error.headers;log.debug(`[error] ${status} ${error.message}`);const debugAllowed=isDebugAllowed();if(!debugAllowed){if(isApiRequest(request)){const isClientError=status>=400&&status<500;const errDetails=error.details;return new Response(buildErrorJson({error:isClientError?error.name||"Client Error":"Internal Server Error",message:isClientError?error.message:"An unexpected error occurred.",status,details:isClientError&&errDetails&&typeof errDetails==="object"?errDetails:undefined}),{status,headers:getJsonHeaders(errorHeaders)})}const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(status),{status,headers:getErrorHeaders("text/html; charset=utf-8",errorHeaders)})}try{const{createErrorHandler}=await import("@stacksjs/error-handling/error-page");const handler=createErrorHandler(getErrorHandlerConfig());handler.setFramework("Stacks","0.70.0");const requestBody=getRequestBody(request);if(requestBody){const url=new URL(request.url);handler.setRequest({method:request.method,url:request.url,headers:Object.fromEntries(request.headers.entries()),queryParams:Object.fromEntries(url.searchParams.entries()),body:requestBody})}else{handler.setRequest(request)}const userContext=await getUserContext(request);if(userContext){handler.setUser(userContext)}if(options?.routingContext){handler.setRouting(options.routingContext)}else if(options?.handlerPath){handler.setRouting({controller:options.handlerPath})}for(const query of getRecentQueries()){handler.addQuery(query.query,query.time,query.connection)}if(isApiRequest(request)){const details={handler:options?.handlerPath};if(isDebugAllowed()){details.stack=error.stack?.split(`
2
+ `).slice(0,10);details.queries=getRecentQueries().slice(-10)}return new Response(buildErrorJson({error:error.name||"Error",message:error.message,status,details}),{status,headers:getJsonHeadersFull()})}const corsOrigin=process.env.APP_URL?process.env.APP_URL.startsWith("http")?process.env.APP_URL:`https://${process.env.APP_URL}`:isDebugAllowed()?"*":request.headers.get("origin")??"null";const html=await handler.render(error,status);return new Response(html,{status,headers:getErrorHeaders("text/html; charset=utf-8",{"Access-Control-Allow-Origin":corsOrigin})})}catch(renderError){console.error("[Error Handler] Failed to render error page:",renderError);const escapeHtml=(s)=>s.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");return new Response(`
3
3
  <html>
4
4
  <head><title>Error</title></head>
5
5
  <body>
@@ -8,4 +8,4 @@ import process from"node:process";import{log}from"@stacksjs/logging/runtime";imp
8
8
  <pre>${escapeHtml(error.stack||"")}</pre>
9
9
  </body>
10
10
  </html>
11
- `,{status,headers:getErrorHeaders("text/html; charset=utf-8")})}}export async function createMiddlewareErrorResponse(error,request){const status=error.statusCode??error.status??500,isDevelopment=isDebugAllowed();if(status>=400&&status<500){if(isApiRequest(request)){const headers=getJsonHeaders(error.headers);return new Response(buildErrorJson({error:error.name||"ClientError",message:error.message,status}),{status,headers})}if(isDevelopment)return await createErrorResponse(error,request,{status});const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(status),{status,headers:getErrorHeaders("text/html; charset=utf-8",error.headers)})}if(isDevelopment)return await createErrorResponse(error,request,{status});return new Response(buildErrorJson({error:"Internal Server Error",message:"An unexpected error occurred.",status}),{status,headers:getJsonHeaders()})}export function createValidationErrorResponse(errors,_request){return new Response(buildErrorJson({error:"ValidationError",message:"Validation failed",status:422,details:{errors}}),{status:422,headers:getJsonHeaders()})}export async function createNotFoundResponse(path,request){if(isDebugAllowed()){const error=Error(`Route not found: ${path}`);error.name="NotFoundError";return await createErrorResponse(error,request,{status:404})}if(isApiRequest(request))return new Response(buildErrorJson({error:"NotFound",message:`Route not found: ${path}`,status:404}),{status:404,headers:getJsonHeaders()});const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(404),{status:404,headers:getErrorHeaders("text/html; charset=utf-8")})}
11
+ `,{status,headers:getErrorHeaders("text/html; charset=utf-8",errorHeaders)})}}export async function createMiddlewareErrorResponse(error,request){const status=error.statusCode??error.status??500;const isDevelopment=isDebugAllowed();if(status>=400&&status<500){if(isApiRequest(request)){const headers=getJsonHeaders(error.headers);return new Response(buildErrorJson({error:error.name||"ClientError",message:error.message,status}),{status,headers})}if(isDevelopment)return await createErrorResponse(error,request,{status});const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(status),{status,headers:getErrorHeaders("text/html; charset=utf-8",error.headers)})}if(isDevelopment){return await createErrorResponse(error,request,{status})}return new Response(buildErrorJson({error:"Internal Server Error",message:"An unexpected error occurred.",status}),{status,headers:getJsonHeaders()})}export function createValidationErrorResponse(errors,_request){return new Response(buildErrorJson({error:"ValidationError",message:"Validation failed",status:422,details:{errors}}),{status:422,headers:getJsonHeaders()})}export async function createNotFoundResponse(path,request){const isDevelopment=isDebugAllowed();if(isDevelopment){const error=new Error(`Route not found: ${path}`);error.name="NotFoundError";return await createErrorResponse(error,request,{status:404})}if(isApiRequest(request)){return new Response(buildErrorJson({error:"NotFound",message:`Route not found: ${path}`,status:404}),{status:404,headers:getJsonHeaders()})}const{renderProductionErrorPage}=await import("@stacksjs/error-handling/error-page");return new Response(renderProductionErrorPage(404),{status:404,headers:getErrorHeaders("text/html; charset=utf-8")})}
package/dist/health.js CHANGED
@@ -1 +1 @@
1
- export async function runHealthProbes(probes,options={}){const timeoutMs=options.timeoutMs??1500,now=options.now??Date.now,entries=await Promise.all(probes.map(async({name,run})=>{const startedAt=now();let timeout;try{await Promise.race([run(),new Promise((_resolve,reject)=>{timeout=setTimeout(()=>reject(Error("timeout")),timeoutMs)})]);return[name,{ok:!0,ms:Math.max(0,now()-startedAt)}]}catch(error){return[name,{ok:!1,ms:Math.max(0,now()-startedAt),message:error instanceof Error?error.message:String(error)}]}finally{if(timeout)clearTimeout(timeout)}})),checks=Object.fromEntries(entries);return{status:Object.values(checks).every((check)=>check.ok)?"healthy":"degraded",checks,timestamp:now()}}export async function checkApplicationHealth(options={}){return runHealthProbes([{name:"database",async run(){const{db}=await import("@stacksjs/database/runtime"),unsafe=db.unsafe;if(typeof unsafe!=="function")throw Error("database driver does not expose a raw health probe");await unsafe.call(db,"SELECT 1")}},{name:"cache",async run(){const{cache}=await import("@stacksjs/cache"),key=`__health__:${Date.now()}`;let stored=!1;try{await cache.set(key,1,5);stored=!0}finally{if(stored)await cache.del(key)}}}],options)}
1
+ export async function runHealthProbes(probes,options={}){const timeoutMs=options.timeoutMs??1500;const now=options.now??Date.now;const entries=await Promise.all(probes.map(async({name,run})=>{const startedAt=now();let timeout;try{await Promise.race([run(),new Promise((_resolve,reject)=>{timeout=setTimeout(()=>reject(new Error("timeout")),timeoutMs)})]);return[name,{ok:true,ms:Math.max(0,now()-startedAt)}]}catch(error){return[name,{ok:false,ms:Math.max(0,now()-startedAt),message:error instanceof Error?error.message:String(error)}]}finally{if(timeout)clearTimeout(timeout)}}));const checks=Object.fromEntries(entries);return{status:Object.values(checks).every((check)=>check.ok)?"healthy":"degraded",checks,timestamp:now()}}export async function checkApplicationHealth(options={}){return runHealthProbes([{name:"database",async run(){const{db}=await import("@stacksjs/database/runtime");const unsafe=db.unsafe;if(typeof unsafe!=="function")throw new Error("database driver does not expose a raw health probe");await unsafe.call(db,"SELECT 1")}},{name:"cache",async run(){const{cache}=await import("@stacksjs/cache");const key=`__health__:${Date.now()}`;let stored=false;try{await cache.set(key,1,5);stored=true}finally{if(stored)await cache.del(key)}}}],options)}
package/dist/json.js CHANGED
@@ -1 +1 @@
1
- export function parseJsonText(text,options={}){if(typeof text!=="string")throw TypeError("JSON text must be a string");const result=JSON.parse(text);if(!options.rejectDuplicateKeys)return result;const containers=[];for(let position=0;position<text.length;position++){const character=text[position];if(character==="{")containers.push(new Set);else if(character==="[")containers.push(null);else if(character==="}"||character==="]")containers.pop();else if(character==='"'){const start=position;while(++position<text.length)if(text[position]==="\\")position++;else if(text[position]==='"')break;let next=position+1;while(next<text.length&&/\s/.test(text[next]))next++;if(text[next]!==":")continue;const keys=containers.at(-1);if(!keys)throw SyntaxError("Invalid JSON object key");const key=JSON.parse(text.slice(start,position+1));if(keys.has(key))throw SyntaxError("Duplicate JSON object key");keys.add(key)}}return result}
1
+ export function parseJsonText(text,options={}){if(typeof text!=="string")throw new TypeError("JSON text must be a string");const result=JSON.parse(text);if(!options.rejectDuplicateKeys)return result;const containers=[];for(let position=0;position<text.length;position++){const character=text[position];if(character==="{")containers.push(new Set);else if(character==="[")containers.push(null);else if(character==="}"||character==="]")containers.pop();else if(character==='"'){const start=position;while(++position<text.length){if(text[position]==="\\")position++;else if(text[position]==='"')break}let next=position+1;while(next<text.length&&/\s/.test(text[next]))next++;if(text[next]!==":")continue;const keys=containers.at(-1);if(!keys)throw new SyntaxError("Invalid JSON object key");const key=JSON.parse(text.slice(start,position+1));if(keys.has(key))throw new SyntaxError("Duplicate JSON object key");keys.add(key)}}return result}
@@ -1 +1 @@
1
- export class PathParamError extends Error{reason;constructor(reason,value,context){const ctx=context?` in ${context}`:"";super(`[router] Refusing to use ${JSON.stringify(value)} as a path parameter${ctx} - ${reason}`);this.name="PathParamError";this.reason=reason}}const CONTROL_CHARS=/[\x00-\x1F\x7F]/;function pathParamRejection(value,options){if(value.length===0)return"empty";const maxLength=options.maxLength??255;if(value.length>maxLength)return"too-long";if(value.includes("\x00"))return"null-byte";if(CONTROL_CHARS.test(value))return"control-char";if(value.startsWith("/")||/^[A-Z]:[\\/]/i.test(value))return"absolute-path";if(/(^|[\\/])\.\.([\\/]|$)/.test(value))return"traversal";if(!options.allowSlashes&&/[\\/]/.test(value))return"traversal";return}export function sanitizePathParam(value,options={}){if(typeof value!=="string")throw new PathParamError("not-string",value,options.context);const reason=pathParamRejection(value,options);if(reason)throw new PathParamError(reason,value,options.context);return value}export function safePathParam(value,options={}){try{if(typeof value!=="string"||pathParamRejection(value,options))return null;return value}catch{return null}}
1
+ export class PathParamError extends Error{reason;constructor(reason,value,context){const ctx=context?` in ${context}`:"";super(`[router] Refusing to use ${JSON.stringify(value)} as a path parameter${ctx} - ${reason}`);this.name="PathParamError";this.reason=reason}}const CONTROL_CHARS=/[\x00-\x1F\x7F]/;function pathParamRejection(value,options){if(value.length===0){return"empty"}const maxLength=options.maxLength??255;if(value.length>maxLength){return"too-long"}if(value.includes("\x00")){return"null-byte"}if(CONTROL_CHARS.test(value)){return"control-char"}if(value.startsWith("/")||/^[A-Z]:[\\/]/i.test(value)){return"absolute-path"}if(/(^|[\\/])\.\.([\\/]|$)/.test(value)){return"traversal"}if(!options.allowSlashes&&/[\\/]/.test(value)){return"traversal"}return}export function sanitizePathParam(value,options={}){if(typeof value!=="string"){throw new PathParamError("not-string",value,options.context)}const reason=pathParamRejection(value,options);if(reason){throw new PathParamError(reason,value,options.context)}return value}export function safePathParam(value,options={}){try{if(typeof value!=="string"||pathParamRejection(value,options)){return null}return value}catch{return null}}
@@ -1,3 +1,3 @@
1
- import process from"node:process";import{getCurrentRequest}from"./request-context";const MAX_QUERIES=50,N1_THRESHOLD=5;function newQueryTrack(){return{buffer:Array(MAX_QUERIES).fill(null),writeIndex:0,count:0,shapeCounts:new Map,n1Warned:new Set}}const REQUEST_QUERY_TRACK_KEY=Symbol.for("stacks.queryTracking");let fallbackTrack;function getRequestTrack(req){let track=req[REQUEST_QUERY_TRACK_KEY];if(!track){track=newQueryTrack();req[REQUEST_QUERY_TRACK_KEY]=track}return track}function getQueryTrack(){const req=getCurrentRequest();return req?getRequestTrack(req):fallbackTrack??=newQueryTrack()}export function isDebugAllowed(){const appEnv=(process.env.APP_ENV??"").toLowerCase();if(appEnv==="development")return!0;if(!appEnv&&process.env.NODE_ENV==="development")return!0;return!1}function normalizeQueryShape(query){return query.replace(/'(?:[^']|'')*'/g,"?").replace(/"(?:[^"]|"")*"/g,"?").replace(/\b\d+(?:\.\d+)?\b/g,"?").replace(/IN\s*\([^)]*\)/gi,"IN (?)").replace(/\s+/g," ").trim().toUpperCase()}export function trackQuery(query,time,connection){const req=getCurrentRequest(),track=req?getRequestTrack(req):fallbackTrack??=newQueryTrack();track.buffer[track.writeIndex]={query,time,connection};track.writeIndex=(track.writeIndex+1)%MAX_QUERIES;if(track.count<MAX_QUERIES)track.count++;if(!req||!isDebugAllowed())return;const shape=normalizeQueryShape(query);if(shape.startsWith("INSERT INTO QUERY_LOGS")||shape.startsWith("EXPLAIN"))return;const next=(track.shapeCounts.get(shape)??0)+1;track.shapeCounts.set(shape,next);if(next===N1_THRESHOLD+1&&!track.n1Warned.has(shape)){track.n1Warned.add(shape);import("@stacksjs/logging").then(({log})=>{log.warn(`[orm] Possible N+1 - query shape ran ${next}\xD7 in this request:
1
+ import process from"node:process";import{getCurrentRequest}from"./request-context";const MAX_QUERIES=50;const N1_THRESHOLD=5;function newQueryTrack(){return{buffer:new Array(MAX_QUERIES).fill(null),writeIndex:0,count:0,shapeCounts:new Map,n1Warned:new Set}}const REQUEST_QUERY_TRACK_KEY=Symbol.for("stacks.queryTracking");let fallbackTrack;function getRequestTrack(req){let track=req[REQUEST_QUERY_TRACK_KEY];if(!track){track=newQueryTrack();req[REQUEST_QUERY_TRACK_KEY]=track}return track}function getQueryTrack(){const req=getCurrentRequest();return req?getRequestTrack(req):fallbackTrack??=newQueryTrack()}export function isDebugAllowed(){const appEnv=(process.env.APP_ENV??"").toLowerCase();if(appEnv==="development")return true;if(!appEnv&&process.env.NODE_ENV==="development")return true;return false}function normalizeQueryShape(query){return query.replace(/'(?:[^']|'')*'/g,"?").replace(/"(?:[^"]|"")*"/g,"?").replace(/\b\d+(?:\.\d+)?\b/g,"?").replace(/IN\s*\([^)]*\)/gi,"IN (?)").replace(/\s+/g," ").trim().toUpperCase()}export function trackQuery(query,time,connection){const req=getCurrentRequest();const track=req?getRequestTrack(req):fallbackTrack??=newQueryTrack();track.buffer[track.writeIndex]={query,time,connection};track.writeIndex=(track.writeIndex+1)%MAX_QUERIES;if(track.count<MAX_QUERIES)track.count++;if(!req||!isDebugAllowed())return;const shape=normalizeQueryShape(query);if(shape.startsWith("INSERT INTO QUERY_LOGS")||shape.startsWith("EXPLAIN"))return;const next=(track.shapeCounts.get(shape)??0)+1;track.shapeCounts.set(shape,next);if(next===N1_THRESHOLD+1&&!track.n1Warned.has(shape)){track.n1Warned.add(shape);import("@stacksjs/logging").then(({log})=>{log.warn(`[orm] Possible N+1 - query shape ran ${next}× in this request:
2
2
  ${shape}
3
- Hint: load related rows with .with('relation') or eager-load via includes() before iterating.`)}).catch(()=>{})}}const QUERY_TRACKER_KEY=Symbol.for("stacks.database.queryTracker");export function registerQueryTracker(){globalThis[QUERY_TRACKER_KEY]=trackQuery}export function getRecentQueries(){const track=getQueryTrack();if(track.count===0)return[];const result=[],start=track.count<MAX_QUERIES?0:track.writeIndex;for(let i=0;i<track.count;i++){const entry=track.buffer[(start+i)%MAX_QUERIES];if(entry)result.push(entry)}return result}export function getQueryShapeCounts(){return new Map(getQueryTrack().shapeCounts)}export function clearTrackedQueries(){const req=getCurrentRequest();if(req){if(req[REQUEST_QUERY_TRACK_KEY])delete req[REQUEST_QUERY_TRACK_KEY];return}fallbackTrack=void 0}
3
+ Hint: load related rows with .with('relation') or eager-load via includes() before iterating.`)}).catch(()=>{})}}const QUERY_TRACKER_KEY=Symbol.for("stacks.database.queryTracker");export function registerQueryTracker(){globalThis[QUERY_TRACKER_KEY]=trackQuery}export function getRecentQueries(){const track=getQueryTrack();if(track.count===0)return[];const result=[];const start=track.count<MAX_QUERIES?0:track.writeIndex;for(let i=0;i<track.count;i++){const entry=track.buffer[(start+i)%MAX_QUERIES];if(entry)result.push(entry)}return result}export function getQueryShapeCounts(){return new Map(getQueryTrack().shapeCounts)}export function clearTrackedQueries(){const req=getCurrentRequest();if(req){if(req[REQUEST_QUERY_TRACK_KEY])delete req[REQUEST_QUERY_TRACK_KEY];return}fallbackTrack=undefined}
@@ -1 +1 @@
1
- import{getCurrentRequest}from"./request-context";import{clientAddress,scaledLimit,sharedRateLimitStorage}from"./security-settings";let limiterCache,limiterModule,httpErrorModule,limiterModulePromise,limiterStorage,limiterStoragePromise;function loadLimiterModule(){return limiterModulePromise??=import("ts-rate-limiter").then((module)=>limiterModule=module)}function loadLimiterStorage(){return limiterStoragePromise??=sharedRateLimitStorage().then((storage)=>limiterStorage=storage)}export function resetRateLimiters(){for(const limiter of limiterCache?.values()??[])limiter.dispose?.();limiterCache=void 0;limiterStorage=void 0;limiterStoragePromise=void 0}function getLimiter(requestedMax,windowMs){const max=scaledLimit(requestedMax),cacheKey=`${windowMs}:${max}`;let limiter=limiterCache?.get(cacheKey);if(!limiter){if(!limiterModule||limiterStorage===void 0)return Promise.all([loadLimiterModule(),loadLimiterStorage()]).then(()=>getLimiter(requestedMax,windowMs));const{RateLimiter}=limiterModule;limiter=new RateLimiter({windowMs,maxRequests:max,algorithm:"fixed-window",...limiterStorage&&{storage:limiterStorage},standardHeaders:!1,legacyHeaders:!1});(limiterCache??=new Map).set(cacheKey,limiter)}return limiter}function resolveIdentity(explicit){if(explicit!==void 0)return explicit;const req=getCurrentRequest();if(!req)return"anon";const id=req._authenticatedUser?.id;if(typeof id==="number"&&Number.isFinite(id)||typeof id==="string"&&id!=="")return`user:${id}`;return`ip:${clientAddress(req)??"unknown"}`}export function rateLimit(key,max,options={}){const run=async(windowMs)=>{const id=resolveIdentity(options.identity),pendingLimiter=getLimiter(max,windowMs),limiter=pendingLimiter instanceof Promise?await pendingLimiter:pendingLimiter,bucketKey=`${key}:${id}`;try{await limiter.enforce(bucketKey)}catch(err){const{RateLimitError}=await loadLimiterModule();if(err instanceof RateLimitError){const{HttpError}=httpErrorModule??=await import("@stacksjs/error-handling/http-error");throw Object.assign(new HttpError(429,"Too many requests",{key,max,retryAfter:err.retryAfter}),{headers:err.toHeaders()})}throw err}};return{async per(period){const seconds=period==="second"?1:period==="minute"?60:period==="hour"?3600:period==="day"?86400:void 0;if(!seconds)throw Error(`rateLimit().per: unknown period '${period}'`);await run(seconds*1000)},async over(ttlSeconds){if(!Number.isFinite(ttlSeconds)||ttlSeconds<=0)throw Error(`rateLimit().over: ttl must be a positive number, got ${ttlSeconds}`);await run(ttlSeconds*1000)}}}export async function rateLimitStatus(key,max,windowSeconds,options={}){const identity=resolveIdentity(options.identity),pendingLimiter=getLimiter(max,windowSeconds*1000),[id,limiter]=typeof identity==="string"&&!(pendingLimiter instanceof Promise)?[identity,pendingLimiter]:await Promise.all([identity,pendingLimiter]),bucketKey=`${key}:${id}`,result=await limiter.peek(bucketKey);if(!result)return null;return{count:result.current,limit:result.limit,remaining:Math.max(0,result.limit-result.current)}}export async function clearRateLimit(key,max,windowSeconds,options={}){const identity=resolveIdentity(options.identity),pendingLimiter=getLimiter(max,windowSeconds*1000),[id,limiter]=typeof identity==="string"&&!(pendingLimiter instanceof Promise)?[identity,pendingLimiter]:await Promise.all([identity,pendingLimiter]),bucketKey=`${key}:${id}`;await limiter.reset(bucketKey)}
1
+ import{getCurrentRequest}from"./request-context";import{clientAddress,scaledLimit,sharedRateLimitStorage}from"./security-settings";let limiterCache;let limiterModule;let httpErrorModule;let limiterModulePromise;let limiterStorage;let limiterStoragePromise;function loadLimiterModule(){return limiterModulePromise??=import("ts-rate-limiter").then((module)=>limiterModule=module)}function loadLimiterStorage(){return limiterStoragePromise??=sharedRateLimitStorage().then((storage)=>limiterStorage=storage)}export function resetRateLimiters(){for(const limiter of limiterCache?.values()??[])limiter.dispose?.();limiterCache=undefined;limiterStorage=undefined;limiterStoragePromise=undefined}function getLimiter(requestedMax,windowMs){const max=scaledLimit(requestedMax);const cacheKey=`${windowMs}:${max}`;let limiter=limiterCache?.get(cacheKey);if(!limiter){if(!limiterModule||limiterStorage===undefined){return Promise.all([loadLimiterModule(),loadLimiterStorage()]).then(()=>getLimiter(requestedMax,windowMs))}const{RateLimiter}=limiterModule;limiter=new RateLimiter({windowMs,maxRequests:max,algorithm:"fixed-window",...limiterStorage&&{storage:limiterStorage},standardHeaders:false,legacyHeaders:false});const cache=limiterCache??=new Map;cache.set(cacheKey,limiter)}return limiter}function resolveIdentity(explicit){if(explicit!==undefined)return explicit;const req=getCurrentRequest();if(!req)return"anon";const id=req._authenticatedUser?.id;if(typeof id==="number"&&Number.isFinite(id)||typeof id==="string"&&id!=="")return`user:${id}`;return`ip:${clientAddress(req)??"unknown"}`}export function rateLimit(key,max,options={}){const run=async(windowMs)=>{const id=resolveIdentity(options.identity);const pendingLimiter=getLimiter(max,windowMs);const limiter=pendingLimiter instanceof Promise?await pendingLimiter:pendingLimiter;const bucketKey=`${key}:${id}`;try{await limiter.enforce(bucketKey)}catch(err){const{RateLimitError}=await loadLimiterModule();if(err instanceof RateLimitError){const{HttpError}=httpErrorModule??=await import("@stacksjs/error-handling/http-error");throw Object.assign(new HttpError(429,"Too many requests",{key,max,retryAfter:err.retryAfter}),{headers:err.toHeaders()})}throw err}};return{async per(period){const seconds=period==="second"?1:period==="minute"?60:period==="hour"?3600:period==="day"?86400:undefined;if(!seconds)throw new Error(`rateLimit().per: unknown period '${period}'`);await run(seconds*1000)},async over(ttlSeconds){if(!Number.isFinite(ttlSeconds)||ttlSeconds<=0){throw new Error(`rateLimit().over: ttl must be a positive number, got ${ttlSeconds}`)}await run(ttlSeconds*1000)}}}export async function rateLimitStatus(key,max,windowSeconds,options={}){const identity=resolveIdentity(options.identity);const pendingLimiter=getLimiter(max,windowSeconds*1000);const[id,limiter]=typeof identity==="string"&&!(pendingLimiter instanceof Promise)?[identity,pendingLimiter]:await Promise.all([identity,pendingLimiter]);const bucketKey=`${key}:${id}`;const result=await limiter.peek(bucketKey);if(!result)return null;return{count:result.current,limit:result.limit,remaining:Math.max(0,result.limit-result.current)}}export async function clearRateLimit(key,max,windowSeconds,options={}){const identity=resolveIdentity(options.identity);const pendingLimiter=getLimiter(max,windowSeconds*1000);const[id,limiter]=typeof identity==="string"&&!(pendingLimiter instanceof Promise)?[identity,pendingLimiter]:await Promise.all([identity,pendingLimiter]);const bucketKey=`${key}:${id}`;await limiter.reset(bucketKey)}
@@ -1,2 +1,2 @@
1
- import{config}from"@stacksjs/config/runtime";import process from"node:process";export function capturedRequestPath(url){let redact=!1;return new URL(url).pathname.split("/").map((part)=>{if(redact||part.length>64)return"[redacted]";let label=part;try{label=decodeURIComponent(part)}catch{}if(/^(?:tokens?|reset|verify|verification|magic-link|password|invitations?)$/i.test(label))redact=!0;return part}).join("/").slice(0,255)}export function requestCaptureEnabled(){const setting=config.server?.captureRequests;return process.env.STACKS_DASHBOARD_WORKER!=="1"&&(setting===!0||typeof setting==="object"&&setting!==null&&setting.enabled!==!1)}function capturePathAllowed(path){if(/^\/(?:api\/dashboard(?:\/|$)|_stx(?:\/|$)|__deps(?:\/|$)|__hmr(?:\/|$)|favicon\.)/.test(path))return!1;const setting=config.server?.captureRequests;return!(typeof setting==="object"&&setting!==null?setting.exclude??[]:[]).some((pattern)=>pattern.endsWith("/*")?path===pattern.slice(0,-2)||path.startsWith(pattern.slice(0,-1)):path===pattern)}export function createRequestCapture(options){const starts=new WeakMap,ignored=new WeakSet;let pending=0,dropped=0,warned=!1,writing=Promise.resolve();const warn=()=>{if(warned)return;warned=!0;try{options.warn?.()}catch{}};function begin(request){if(!options.enabled()||starts.has(request)||ignored.has(request))return!1;const path=capturedRequestPath(request.url);if(options.allowed&&!options.allowed(path))return!1;starts.set(request,{time:performance.now(),path});return!0}function finish(request,response){const start=starts.get(request);if(!start)return;starts.delete(request);if(pending>=(options.maxPending??100)){dropped++;warn();return}const row={method:request.method.slice(0,255),path:start.path,status_code:response.status,duration_ms:Math.min(2147483647,Math.max(0,Math.round(performance.now()-start.time))),memory_usage:Math.round(process.memoryUsage().heapUsed/1024/1024),ip_address:"",user_agent:"",error_message:response.status>=500?`HTTP ${response.status}`:"",occurredAt:new Date};pending++;writing=writing.then(()=>options.store(row)).catch(()=>{dropped++;warn()}).finally(()=>{pending--})}return{begin,finish,skip(request){if(starts.delete(request))ignored.add(request)},observe(request,run){if(!begin(request))return run();try{const result=run();if(result instanceof Promise)return result.then((response)=>{if(response instanceof Response)finish(request,response);return response},(error)=>{finish(request,{status:500});throw error});if(result instanceof Response)finish(request,result);return result}catch(error){finish(request,{status:500});throw error}},async flush(){while(pending>0)await writing},stats(){return{pending,dropped}}}}const capture=createRequestCapture({enabled:requestCaptureEnabled,allowed:capturePathAllowed,async store({occurredAt,...row}){const{db,sqlDateTime}=await import("@stacksjs/database/runtime"),timestamp=sqlDateTime(occurredAt);await db.insertInto("requests").values({...row,created_at:timestamp,updated_at:timestamp}).execute()},warn(){process.stderr.write(`[http-capture] Request metadata storage unavailable or buffer full; some observations were dropped.
2
- `)}});export const{begin:beginRequestCapture,finish:finishRequestCapture,skip:skipRequestCapture,observe:observeHttpRequest,flush:flushRequestCaptures}=capture;
1
+ import{config}from"@stacksjs/config/runtime";import process from"node:process";export function capturedRequestPath(url){let redact=false;return new URL(url).pathname.split("/").map((part)=>{if(redact||part.length>64)return"[redacted]";let label=part;try{label=decodeURIComponent(part)}catch{}if(/^(?:tokens?|reset|verify|verification|magic-link|password|invitations?)$/i.test(label))redact=true;return part}).join("/").slice(0,255)}export function requestCaptureEnabled(){const setting=config.server?.captureRequests;return process.env.STACKS_DASHBOARD_WORKER!=="1"&&(setting===true||typeof setting==="object"&&setting!==null&&setting.enabled!==false)}function capturePathAllowed(path){if(/^\/(?:api\/dashboard(?:\/|$)|_stx(?:\/|$)|__deps(?:\/|$)|__hmr(?:\/|$)|favicon\.)/.test(path))return false;const setting=config.server?.captureRequests;const exclusions=typeof setting==="object"&&setting!==null?setting.exclude??[]:[];return!exclusions.some((pattern)=>pattern.endsWith("/*")?path===pattern.slice(0,-2)||path.startsWith(pattern.slice(0,-1)):path===pattern)}export function createRequestCapture(options){const starts=new WeakMap;const ignored=new WeakSet;let pending=0;let dropped=0;let warned=false;let writing=Promise.resolve();const warn=()=>{if(warned)return;warned=true;try{options.warn?.()}catch{}};function begin(request){if(!options.enabled()||starts.has(request)||ignored.has(request))return false;const path=capturedRequestPath(request.url);if(options.allowed&&!options.allowed(path))return false;starts.set(request,{time:performance.now(),path});return true}function finish(request,response){const start=starts.get(request);if(!start)return;starts.delete(request);if(pending>=(options.maxPending??100)){dropped++;warn();return}const row={method:request.method.slice(0,255),path:start.path,status_code:response.status,duration_ms:Math.min(2147483647,Math.max(0,Math.round(performance.now()-start.time))),memory_usage:Math.round(process.memoryUsage().heapUsed/1024/1024),ip_address:"",user_agent:"",error_message:response.status>=500?`HTTP ${response.status}`:"",occurredAt:new Date};pending++;writing=writing.then(()=>options.store(row)).catch(()=>{dropped++;warn()}).finally(()=>{pending--})}return{begin,finish,skip(request){if(starts.delete(request))ignored.add(request)},observe(request,run){if(!begin(request))return run();try{const result=run();if(result instanceof Promise){return result.then((response)=>{if(response instanceof Response)finish(request,response);return response},(error)=>{finish(request,{status:500});throw error})}if(result instanceof Response)finish(request,result);return result}catch(error){finish(request,{status:500});throw error}},async flush(){while(pending>0)await writing},stats(){return{pending,dropped}}}}const capture=createRequestCapture({enabled:requestCaptureEnabled,allowed:capturePathAllowed,async store({occurredAt,...row}){const{db,sqlDateTime}=await import("@stacksjs/database/runtime");const timestamp=sqlDateTime(occurredAt);await db.insertInto("requests").values({...row,created_at:timestamp,updated_at:timestamp}).execute()},warn(){process.stderr.write(`[http-capture] Request metadata storage unavailable or buffer full; some observations were dropped.
2
+ `)}});export const beginRequestCapture=capture.begin;export const finishRequestCapture=capture.finish;export const skipRequestCapture=capture.skip;export const observeHttpRequest=capture.observe;export const flushRequestCaptures=capture.flush;
@@ -1 +1 @@
1
- import process from"node:process";import{AsyncLocalStorage}from"node:async_hooks";import{log}from"@stacksjs/logging/runtime";const REQUEST_STORAGE_KEY=Symbol.for("stacks.router.requestStorage"),requestStorage=globalThis[REQUEST_STORAGE_KEY]??=new AsyncLocalStorage,TRACE_STORAGE_KEY=Symbol.for("stacks.router.traceStorage"),traceStorage=globalThis[TRACE_STORAGE_KEY]??=new AsyncLocalStorage;export function getTraceId(){const explicit=traceStorage.getStore();if(explicit)return explicit;return requestStorage.getStore()?._requestId}export function withTraceId(id,fn){return traceStorage.run(id,fn)}const REQUEST_QUERY_CACHE_KEY=Symbol.for("stacks.requestQueryCache");function getRequestCache(){const req=requestStorage.getStore();if(!req)return;let cache=req[REQUEST_QUERY_CACHE_KEY];if(!cache){cache={map:new Map};req[REQUEST_QUERY_CACHE_KEY]=cache}return cache}export function cacheRequestQuery(key,fetcher){try{const cache=getRequestCache(),existing=cache?.map.get(key);if(existing)return existing.then();return startQuery(cache,key,fetcher)}catch(error){return Promise.reject(error)}}function startQuery(cache,key,fetcher){if(!cache)return uncachedQuery(fetcher);const promise=Promise.resolve().then(()=>fetcher());cache.map.set(key,promise);promise.catch(()=>cache.map.delete(key));return promise.then()}async function uncachedQuery(fetcher){return fetcher()}export function setCurrentRequest(req){log.debug(`[request] ${req.method} ${new URL(req.url).pathname}`);requestStorage.enterWith(req)}export function clearCurrentRequest(){requestStorage.enterWith(void 0)}let ambientContextEnabled=!0;export function setAmbientRequestContext(enabled){ambientContextEnabled=enabled}export function ambientRequestContextEnabled(){return ambientContextEnabled}export function runWithRequest(req,fn){return ambientContextEnabled?requestStorage.run(req,fn):fn()}export function runWithRequestArgument(req,fn,arg){return ambientContextEnabled?requestStorage.run(req,fn,arg):fn(arg)}export function runWithRequestArguments(req,fn,first,second,third){return ambientContextEnabled?requestStorage.run(req,fn,first,second,third):fn(first,second,third)}export function getCurrentRequest(){return requestStorage.getStore()}export const request=new Proxy({},{get(_target,prop){const currentRequest=getCurrentRequest();if(!currentRequest){if(!ambientContextEnabled)throw Error(`request.${String(prop)} needs the ambient request context, which this process disabled with createStacksRouter({ requestContext: false }). Take the request as a handler argument, or re-enable it.`);if(process.env.NODE_ENV!=="production")console.warn(`[RequestContext] Accessing request.${String(prop)} outside of request context`);if(prop==="bearerToken")return()=>null;if(prop==="user"||prop==="userToken")return async()=>{return};if(prop==="tokenCan"||prop==="tokenCant")return async()=>!1;if(prop==="headers")return new Headers;if(prop==="url")return"";if(prop==="method")return"GET";return}const value=currentRequest[prop];if(typeof value==="function")return value.bind(currentRequest);return value}});
1
+ import process from"node:process";import{AsyncLocalStorage}from"node:async_hooks";import{log}from"@stacksjs/logging/runtime";const REQUEST_STORAGE_KEY=Symbol.for("stacks.router.requestStorage");const requestStorage=globalThis[REQUEST_STORAGE_KEY]??=new AsyncLocalStorage;const TRACE_STORAGE_KEY=Symbol.for("stacks.router.traceStorage");const traceStorage=globalThis[TRACE_STORAGE_KEY]??=new AsyncLocalStorage;export function getTraceId(){const explicit=traceStorage.getStore();if(explicit)return explicit;const req=requestStorage.getStore();return req?._requestId}export function withTraceId(id,fn){return traceStorage.run(id,fn)}const REQUEST_QUERY_CACHE_KEY=Symbol.for("stacks.requestQueryCache");function getRequestCache(){const req=requestStorage.getStore();if(!req)return;let cache=req[REQUEST_QUERY_CACHE_KEY];if(!cache){cache={map:new Map};req[REQUEST_QUERY_CACHE_KEY]=cache}return cache}export function cacheRequestQuery(key,fetcher){try{const cache=getRequestCache();const existing=cache?.map.get(key);if(existing)return existing.then();return startQuery(cache,key,fetcher)}catch(error){return Promise.reject(error)}}function startQuery(cache,key,fetcher){if(!cache)return uncachedQuery(fetcher);const promise=Promise.resolve().then(()=>fetcher());cache.map.set(key,promise);promise.catch(()=>cache.map.delete(key));return promise.then()}async function uncachedQuery(fetcher){return fetcher()}export function setCurrentRequest(req){log.debug(`[request] ${req.method} ${new URL(req.url).pathname}`);requestStorage.enterWith(req)}export function clearCurrentRequest(){requestStorage.enterWith(undefined)}let ambientContextEnabled=true;export function setAmbientRequestContext(enabled){ambientContextEnabled=enabled}export function ambientRequestContextEnabled(){return ambientContextEnabled}export function runWithRequest(req,fn){return ambientContextEnabled?requestStorage.run(req,fn):fn()}export function runWithRequestArgument(req,fn,arg){return ambientContextEnabled?requestStorage.run(req,fn,arg):fn(arg)}export function runWithRequestArguments(req,fn,first,second,third){return ambientContextEnabled?requestStorage.run(req,fn,first,second,third):fn(first,second,third)}export function getCurrentRequest(){return requestStorage.getStore()}export const request=new Proxy({},{get(_target,prop){const currentRequest=getCurrentRequest();if(!currentRequest){if(!ambientContextEnabled){throw new Error(`request.${String(prop)} needs the ambient request context, which this process disabled with `+`createStacksRouter({ requestContext: false }). Take the request as a handler argument, or re-enable it.`)}if(process.env.NODE_ENV!=="production"){console.warn(`[RequestContext] Accessing request.${String(prop)} outside of request context`)}if(prop==="bearerToken"){return()=>null}if(prop==="user"||prop==="userToken"){return async()=>{return}}if(prop==="tokenCan"||prop==="tokenCant"){return async()=>false}if(prop==="headers"){return new Headers}if(prop==="url"){return""}if(prop==="method"){return"GET"}return}const value=currentRequest[prop];if(typeof value==="function"){return value.bind(currentRequest)}return value}});
@@ -1 +1 @@
1
- import{existsSync}from"node:fs";import{log}from"@stacksjs/logging/runtime";import{route,withFallbackRouteNames}from"./stacks-router";let rootMountedAppRoutes;export function listRootMountedAppRoutes(){return rootMountedAppRoutes??=[]}export const DEFAULT_ROUTE_REGISTRY={api:"api"};export async function appRouteRegistry(){const{projectPath}=await import("@stacksjs/path"),file=projectPath("app/Routes.ts");if(!existsSync(file))return DEFAULT_ROUTE_REGISTRY;const registry=(await import(file)).default;if(!registry||typeof registry!=="object"||Object.keys(registry).length===0){log.debug("[route-loader] app/Routes.ts exports no registry; using the default");return DEFAULT_ROUTE_REGISTRY}return registry}export async function loadRoutes(registry){for(const[key,definition]of Object.entries(registry)){const config=normalizeDefinition(definition),prefix=config.prefix!==void 0?config.prefix?config.prefix.startsWith("/")?config.prefix:`/${config.prefix}`:void 0:key==="web"?void 0:`/${key}`,middleware=normalizeMiddleware(config.middleware);log.debug(`[route-loader] Loading: ${config.path} prefix=${prefix||"/"} middleware=[${middleware.join(", ")}]`);try{if(prefix||middleware.length>0)await route.group({prefix,middleware:middleware.length>0?middleware:void 0},async()=>{await importRouteFile(config.path)});else{const before=registeredRouteKeys();await importRouteFile(config.path);for(const entry of currentRouteTable()){const method=String(entry.method??"").toUpperCase(),path=String(entry.path??"");if(!method||!path||before.has(`${method} ${path}`))continue;(rootMountedAppRoutes??=[]).push({method,path,file:`routes/${config.path}.ts`})}}}catch(error){const message=error instanceof Error?error.message:String(error);console.error(`[Routes] Failed to load route file '${config.path}': ${message}`);throw Error(`Route loading failed for '${config.path}': ${message}`)}}await loadFrameworkRoutes()}export const DEFAULT_ROUTE_BUNDLES=["auth","dashboard","delivery","email","forms","payments"],OPT_IN_ROUTE_BUNDLES=["social"],DEFAULT_ROUTE_BUNDLES_KEY="__stacksDefaultRouteBundles";export function resolveDefaultRouteBundles(env=process.env){return resolveDefaultRouteBundlesWithDiagnostics(env).bundles}export function resolveDefaultRouteBundlesWithDiagnostics(env=process.env){const all=()=>new Set(DEFAULT_ROUTE_BUNDLES),raw=env.STACKS_DEFAULT_ROUTES;if(raw!==void 0){const names=raw.split(",").map((name)=>name.trim().toLowerCase()).filter(Boolean);if(names.length===0||names.includes("none"))return{bundles:new Set,unknown:[],explicit:!0};if(names.includes("all"))return{bundles:all(),unknown:[],explicit:!0};const bundles=new Set,unknown=[];for(const name of names)if(DEFAULT_ROUTE_BUNDLES.includes(name)||OPT_IN_ROUTE_BUNDLES.includes(name))bundles.add(name);else unknown.push(name);return{bundles,unknown,explicit:!0}}if(env.STACKS_SKIP_DEFAULT_ROUTES==="1")return{bundles:new Set,unknown:[],explicit:!0};return{bundles:all(),unknown:[],explicit:!1}}export const DEFAULT_ROUTE_BUNDLE_FEATURES={auth:"dashboard",dashboard:"dashboard",delivery:"commerce",email:"email",forms:"forms",payments:"commerce"};export function bundleMounts(selection,bundle,featureEnabled){if(selection&&!selection.bundles.has(bundle))return!1;return selection?.explicit?!0:featureEnabled}export function mountedDefaultRouteBundles(featureEnabled,env=process.env){const selection=resolveDefaultRouteBundlesWithDiagnostics(env),mounted=new Set;for(const bundle of DEFAULT_ROUTE_BUNDLES)if(bundleMounts(selection,bundle,featureEnabled(DEFAULT_ROUTE_BUNDLE_FEATURES[bundle])))mounted.add(bundle);return mounted}async function loadFrameworkRoutes(){const{bundles,unknown,explicit}=resolveDefaultRouteBundlesWithDiagnostics();for(const name of unknown)log.warn(`[Routes] STACKS_DEFAULT_ROUTES lists unknown bundle "${name}" - known bundles are ${DEFAULT_ROUTE_BUNDLES.join(", ")}.`);if(bundles.size===0)return;globalThis[DEFAULT_ROUTE_BUNDLES_KEY]={bundles,explicit};try{try{const{overridesReady}=await import("@stacksjs/config");await overridesReady}catch{}const{frameworkPath}=await import("@stacksjs/path"),bootstrapPath=frameworkPath("defaults/bootstrap.ts");if(await Bun.file(bootstrapPath).exists())await withFallbackRouteNames(()=>import(bootstrapPath))}catch(error){const message=error instanceof Error?error.message:String(error);if(!message.includes("Cannot find module")&&!message.includes("MODULE_NOT_FOUND"))console.error(`[Routes] Failed to load framework bootstrap: ${message}`)}}function assertSafeRouteName(routeName){if(typeof routeName!=="string"||routeName.length===0)throw Error("[route-loader] Invalid route path: empty or non-string");if(routeName.includes("\x00"))throw Error("[route-loader] Invalid route path: null byte");let decoded;try{decoded=decodeURIComponent(routeName)}catch{throw Error("[route-loader] Invalid route path: malformed URL encoding")}const cleanPath=decoded.replace(/\.ts$/,"");if(cleanPath.startsWith("/")||/^[A-Za-z]:[\\/]/.test(cleanPath))throw Error(`[route-loader] Invalid route path: absolute paths not allowed (${cleanPath})`);if(cleanPath.split(/[/\\]/).some((s)=>s===".."))throw Error(`[route-loader] Invalid route path: '..' segment not allowed (${cleanPath})`);return cleanPath}async function importRouteFile(routeName){const cleanPath=assertSafeRouteName(routeName),{isCompiledBinary,projectPath}=await import("@stacksjs/path");if(isCompiledBinary())throw Error(`[route-loader] Cannot load routes/${cleanPath} from a compiled binary: route files are read from disk at runtime, and a disk file cannot resolve the framework packages it imports from inside the bundle. Import the route file statically (\`import '../routes/${cleanPath}'\`) so it is bundled, or run the app with \`bun\` instead of compiling it.`);await import(projectPath(`routes/${cleanPath}`))}function normalizeDefinition(def){if(typeof def==="string")return{path:def};return def}function normalizeMiddleware(middleware){if(!middleware)return[];if(typeof middleware==="string")return[middleware];return middleware}function currentRouteTable(){return route.routes??[]}function registeredRouteKeys(){const keys=new Set;for(const entry of currentRouteTable())keys.add(`${String(entry.method??"").toUpperCase()} ${String(entry.path??"")}`);return keys}
1
+ import{existsSync}from"node:fs";import{log}from"@stacksjs/logging/runtime";import{route,withFallbackRouteNames}from"./stacks-router";let rootMountedAppRoutes;export function listRootMountedAppRoutes(){return rootMountedAppRoutes??=[]}export const DEFAULT_ROUTE_REGISTRY={api:"api"};export async function appRouteRegistry(){const{projectPath}=await import("@stacksjs/path");const file=projectPath("app/Routes.ts");if(!existsSync(file))return DEFAULT_ROUTE_REGISTRY;const registry=(await import(file)).default;if(!registry||typeof registry!=="object"||Object.keys(registry).length===0){log.debug("[route-loader] app/Routes.ts exports no registry; using the default");return DEFAULT_ROUTE_REGISTRY}return registry}export async function loadRoutes(registry){for(const[key,definition]of Object.entries(registry)){const config=normalizeDefinition(definition);const prefix=config.prefix!==undefined?config.prefix?config.prefix.startsWith("/")?config.prefix:`/${config.prefix}`:undefined:key==="web"?undefined:`/${key}`;const middleware=normalizeMiddleware(config.middleware);log.debug(`[route-loader] Loading: ${config.path} prefix=${prefix||"/"} middleware=[${middleware.join(", ")}]`);try{if(prefix||middleware.length>0){await route.group({prefix,middleware:middleware.length>0?middleware:undefined},async()=>{await importRouteFile(config.path)})}else{const before=registeredRouteKeys();await importRouteFile(config.path);for(const entry of currentRouteTable()){const method=String(entry.method??"").toUpperCase();const path=String(entry.path??"");if(!method||!path||before.has(`${method} ${path}`))continue;const routes=rootMountedAppRoutes??=[];routes.push({method,path,file:`routes/${config.path}.ts`})}}}catch(error){const message=error instanceof Error?error.message:String(error);console.error(`[Routes] Failed to load route file '${config.path}': ${message}`);throw new Error(`Route loading failed for '${config.path}': ${message}`)}}await loadFrameworkRoutes()}export const DEFAULT_ROUTE_BUNDLES=["auth","dashboard","delivery","email","forms","payments"];export const OPT_IN_ROUTE_BUNDLES=["social"];export const DEFAULT_ROUTE_BUNDLES_KEY="__stacksDefaultRouteBundles";export function resolveDefaultRouteBundles(env=process.env){return resolveDefaultRouteBundlesWithDiagnostics(env).bundles}export function resolveDefaultRouteBundlesWithDiagnostics(env=process.env){const all=()=>new Set(DEFAULT_ROUTE_BUNDLES);const raw=env.STACKS_DEFAULT_ROUTES;if(raw!==undefined){const names=raw.split(",").map((name)=>name.trim().toLowerCase()).filter(Boolean);if(names.length===0||names.includes("none"))return{bundles:new Set,unknown:[],explicit:true};if(names.includes("all"))return{bundles:all(),unknown:[],explicit:true};const bundles=new Set;const unknown=[];for(const name of names){if(DEFAULT_ROUTE_BUNDLES.includes(name)||OPT_IN_ROUTE_BUNDLES.includes(name)){bundles.add(name)}else{unknown.push(name)}}return{bundles,unknown,explicit:true}}if(env.STACKS_SKIP_DEFAULT_ROUTES==="1")return{bundles:new Set,unknown:[],explicit:true};return{bundles:all(),unknown:[],explicit:false}}export const DEFAULT_ROUTE_BUNDLE_FEATURES={auth:"dashboard",dashboard:"dashboard",delivery:"commerce",email:"email",forms:"forms",payments:"commerce"};export function bundleMounts(selection,bundle,featureEnabled){if(selection&&!selection.bundles.has(bundle))return false;return selection?.explicit?true:featureEnabled}export function mountedDefaultRouteBundles(featureEnabled,env=process.env){const selection=resolveDefaultRouteBundlesWithDiagnostics(env);const mounted=new Set;for(const bundle of DEFAULT_ROUTE_BUNDLES){if(bundleMounts(selection,bundle,featureEnabled(DEFAULT_ROUTE_BUNDLE_FEATURES[bundle])))mounted.add(bundle)}return mounted}async function loadFrameworkRoutes(){const{bundles,unknown,explicit}=resolveDefaultRouteBundlesWithDiagnostics();for(const name of unknown)log.warn(`[Routes] STACKS_DEFAULT_ROUTES lists unknown bundle "${name}" - known bundles are ${DEFAULT_ROUTE_BUNDLES.join(", ")}.`);if(bundles.size===0)return;globalThis[DEFAULT_ROUTE_BUNDLES_KEY]={bundles,explicit};try{try{const{overridesReady}=await import("@stacksjs/config");await overridesReady}catch{}const{frameworkPath}=await import("@stacksjs/path");const bootstrapPath=frameworkPath("defaults/bootstrap.ts");if(await Bun.file(bootstrapPath).exists()){await withFallbackRouteNames(()=>import(bootstrapPath))}}catch(error){const message=error instanceof Error?error.message:String(error);if(!message.includes("Cannot find module")&&!message.includes("MODULE_NOT_FOUND")){console.error(`[Routes] Failed to load framework bootstrap: ${message}`)}}}function assertSafeRouteName(routeName){if(typeof routeName!=="string"||routeName.length===0)throw new Error(`[route-loader] Invalid route path: empty or non-string`);if(routeName.includes("\x00"))throw new Error(`[route-loader] Invalid route path: null byte`);let decoded;try{decoded=decodeURIComponent(routeName)}catch{throw new Error(`[route-loader] Invalid route path: malformed URL encoding`)}const cleanPath=decoded.replace(/\.ts$/,"");if(cleanPath.startsWith("/")||/^[A-Za-z]:[\\/]/.test(cleanPath))throw new Error(`[route-loader] Invalid route path: absolute paths not allowed (${cleanPath})`);const segments=cleanPath.split(/[/\\]/);if(segments.some((s)=>s===".."))throw new Error(`[route-loader] Invalid route path: '..' segment not allowed (${cleanPath})`);return cleanPath}async function importRouteFile(routeName){const cleanPath=assertSafeRouteName(routeName);const{isCompiledBinary,projectPath}=await import("@stacksjs/path");if(isCompiledBinary()){throw new Error(`[route-loader] Cannot load routes/${cleanPath} from a compiled binary: route files are read from disk at runtime, and a disk file cannot resolve the framework packages it imports from inside the bundle. Import the route file statically (\`import '../routes/${cleanPath}'\`) so it is bundled, or run the app with \`bun\` instead of compiling it.`)}await import(projectPath(`routes/${cleanPath}`))}function normalizeDefinition(def){if(typeof def==="string"){return{path:def}}return def}function normalizeMiddleware(middleware){if(!middleware)return[];if(typeof middleware==="string")return[middleware];return middleware}function currentRouteTable(){return route.routes??[]}function registeredRouteKeys(){const keys=new Set;for(const entry of currentRouteTable())keys.add(`${String(entry.method??"").toUpperCase()} ${String(entry.path??"")}`);return keys}
@@ -1 +1 @@
1
- let bindings,fallbackResolver=null;export function defineRouteModelBinding(param,resolver){(bindings??=new Map).set(param,resolver)}export function setRouteModelFallback(resolver){fallbackResolver=resolver}export function routeModelBindings(){return bindings?[...bindings.keys()].sort():[]}export function clearRouteModelBindings(){bindings=void 0;fallbackResolver=null}export async function resolveRouteModel(param,value,request){const resolver=bindings?.get(param)??fallbackResolver;if(!resolver)return{bound:!1};try{const model=await resolver(value,{param,request});if(model===void 0)return{bound:!1};return{bound:!0,model:model??void 0}}catch{return{bound:!0,model:void 0}}}
1
+ let bindings;let fallbackResolver=null;export function defineRouteModelBinding(param,resolver){const registry=bindings??=new Map;registry.set(param,resolver)}export function setRouteModelFallback(resolver){fallbackResolver=resolver}export function routeModelBindings(){return bindings?[...bindings.keys()].sort():[]}export function clearRouteModelBindings(){bindings=undefined;fallbackResolver=null}export async function resolveRouteModel(param,value,request){const resolver=bindings?.get(param)??fallbackResolver;if(!resolver)return{bound:false};try{const model=await resolver(value,{param,request});if(model===undefined)return{bound:false};return{bound:true,model:model??undefined}}catch{return{bound:true,model:undefined}}}
@@ -1 +1 @@
1
- import process from"node:process";let _isProductionCache,_isDisabledCache,_cspCache,_headerTemplateCache,_jsonHeaderTemplateCache,_jsonMetadataHeaderTemplates,_jsonLengthHeaderTemplateCache,_jsonUncachedLengthHeaderTemplates;const JSON_LENGTH_HEADER_CACHE_LIMIT=64;function isProduction(){if(_isProductionCache!==void 0)return _isProductionCache;_isProductionCache=(process.env.APP_ENV??process.env.NODE_ENV??"").toLowerCase()==="production";return _isProductionCache}function isDisabled(){if(_isDisabledCache!==void 0)return _isDisabledCache;_isDisabledCache=process.env.STACKS_SECURITY_HEADERS_DISABLE==="true";return _isDisabledCache}function resolveCsp(){if(_cspCache!==void 0)return _cspCache;const enforce=process.env.STACKS_CSP,report=process.env.STACKS_CSP_REPORT_ONLY;if(enforce)_cspCache={header:"Content-Security-Policy",value:enforce};else if(report)_cspCache={header:"Content-Security-Policy-Report-Only",value:report};else _cspCache=null;return _cspCache}export function applySecurityHeaders(headers,knownMissing=!1){if(isDisabled())return;if(knownMissing||headers.get("X-Content-Type-Options")===null)headers.set("X-Content-Type-Options","nosniff");if(knownMissing||headers.get("X-Frame-Options")===null)headers.set("X-Frame-Options","SAMEORIGIN");if(knownMissing||headers.get("Referrer-Policy")===null)headers.set("Referrer-Policy","strict-origin-when-cross-origin");if(isProduction()&&(knownMissing||headers.get("Strict-Transport-Security")===null))headers.set("Strict-Transport-Security","max-age=31536000; includeSubDomains");const csp=resolveCsp();if(csp&&(knownMissing||headers.get(csp.header)===null))headers.set(csp.header,csp.value)}export function applySecurityHeadersToRecord(headers){if(isDisabled())return;headers["X-Content-Type-Options"]="nosniff";headers["X-Frame-Options"]="SAMEORIGIN";headers["Referrer-Policy"]="strict-origin-when-cross-origin";if(isProduction())headers["Strict-Transport-Security"]="max-age=31536000; includeSubDomains";const csp=resolveCsp();if(csp)headers[csp.header]=csp.value}function securityHeadersTemplate(){if(!_headerTemplateCache){_headerTemplateCache=new Headers;applySecurityHeaders(_headerTemplateCache,!0)}return _headerTemplateCache}export function createSecurityHeaders(){return new Headers(securityHeadersTemplate())}function jsonSecurityHeadersTemplate(){if(!_jsonHeaderTemplateCache){_jsonHeaderTemplateCache=new Headers(securityHeadersTemplate());_jsonHeaderTemplateCache.set("Content-Type","application/json;charset=utf-8")}return _jsonHeaderTemplateCache}export function createJsonSecurityHeaders(){return new Headers(jsonSecurityHeadersTemplate())}export function secureSerializedJsonResponse(body,bodyLength,requestId,csrfCookie){if(bodyLength===void 0){const templates=_jsonMetadataHeaderTemplates??={};if(!requestId&&!csrfCookie)return new Response(body,templates.plain??={headers:jsonSecurityHeadersTemplate()});if(csrfCookie){const responseInit=requestId?templates.withCsrfAndRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:templates.withCsrf??={headers:new Headers(jsonSecurityHeadersTemplate())};responseInit.headers.set("Set-Cookie",csrfCookie);if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const responseInit=templates.withRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())};if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const templates=_jsonLengthHeaderTemplateCache??=new Map;let lengthTemplates=templates.get(bodyLength);if(!lengthTemplates&&templates.size<JSON_LENGTH_HEADER_CACHE_LIMIT){const headers=new Headers(jsonSecurityHeadersTemplate());headers.set("Content-Length",String(bodyLength));lengthTemplates={plain:{headers}};templates.set(bodyLength,lengthTemplates)}if(lengthTemplates){if(csrfCookie){const responseInit=requestId?lengthTemplates.withCsrfAndRequestId??={headers:new Headers(lengthTemplates.plain.headers)}:lengthTemplates.withCsrf??={headers:new Headers(lengthTemplates.plain.headers)};responseInit.headers.set("Set-Cookie",csrfCookie);if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}if(!requestId)return new Response(body,lengthTemplates.plain);const responseInit=lengthTemplates.withRequestId??={headers:new Headers(lengthTemplates.plain.headers)};responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const uncached=_jsonUncachedLengthHeaderTemplates??={},responseInit=csrfCookie?requestId?uncached.withCsrfAndRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:uncached.withCsrf??={headers:new Headers(jsonSecurityHeadersTemplate())}:requestId?uncached.withRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:uncached.plain??={headers:new Headers(jsonSecurityHeadersTemplate())};responseInit.headers.set("Content-Length",String(bodyLength));if(requestId)responseInit.headers.set("X-Request-ID",requestId);if(csrfCookie)responseInit.headers.set("Set-Cookie",csrfCookie);return new Response(body,responseInit)}export function __resetSecurityHeadersCache(){_isProductionCache=void 0;_isDisabledCache=void 0;_cspCache=void 0;_headerTemplateCache=void 0;_jsonHeaderTemplateCache=void 0;_jsonMetadataHeaderTemplates=void 0;_jsonLengthHeaderTemplateCache=void 0;_jsonUncachedLengthHeaderTemplates=void 0}
1
+ import process from"node:process";let _isProductionCache;let _isDisabledCache;let _cspCache;let _headerTemplateCache;let _jsonHeaderTemplateCache;let _jsonMetadataHeaderTemplates;let _jsonLengthHeaderTemplateCache;let _jsonUncachedLengthHeaderTemplates;const JSON_LENGTH_HEADER_CACHE_LIMIT=64;function isProduction(){if(_isProductionCache!==undefined)return _isProductionCache;const env=(process.env.APP_ENV??process.env.NODE_ENV??"").toLowerCase();_isProductionCache=env==="production";return _isProductionCache}function isDisabled(){if(_isDisabledCache!==undefined)return _isDisabledCache;_isDisabledCache=process.env.STACKS_SECURITY_HEADERS_DISABLE==="true";return _isDisabledCache}function resolveCsp(){if(_cspCache!==undefined)return _cspCache;const enforce=process.env.STACKS_CSP;const report=process.env.STACKS_CSP_REPORT_ONLY;if(enforce)_cspCache={header:"Content-Security-Policy",value:enforce};else if(report)_cspCache={header:"Content-Security-Policy-Report-Only",value:report};else _cspCache=null;return _cspCache}export function applySecurityHeaders(headers,knownMissing=false){if(isDisabled())return;if(knownMissing||headers.get("X-Content-Type-Options")===null)headers.set("X-Content-Type-Options","nosniff");if(knownMissing||headers.get("X-Frame-Options")===null)headers.set("X-Frame-Options","SAMEORIGIN");if(knownMissing||headers.get("Referrer-Policy")===null)headers.set("Referrer-Policy","strict-origin-when-cross-origin");if(isProduction()&&(knownMissing||headers.get("Strict-Transport-Security")===null))headers.set("Strict-Transport-Security","max-age=31536000; includeSubDomains");const csp=resolveCsp();if(csp&&(knownMissing||headers.get(csp.header)===null))headers.set(csp.header,csp.value)}export function applySecurityHeadersToRecord(headers){if(isDisabled())return;headers["X-Content-Type-Options"]="nosniff";headers["X-Frame-Options"]="SAMEORIGIN";headers["Referrer-Policy"]="strict-origin-when-cross-origin";if(isProduction())headers["Strict-Transport-Security"]="max-age=31536000; includeSubDomains";const csp=resolveCsp();if(csp)headers[csp.header]=csp.value}function securityHeadersTemplate(){if(!_headerTemplateCache){_headerTemplateCache=new Headers;applySecurityHeaders(_headerTemplateCache,true)}return _headerTemplateCache}export function createSecurityHeaders(){return new Headers(securityHeadersTemplate())}function jsonSecurityHeadersTemplate(){if(!_jsonHeaderTemplateCache){_jsonHeaderTemplateCache=new Headers(securityHeadersTemplate());_jsonHeaderTemplateCache.set("Content-Type","application/json;charset=utf-8")}return _jsonHeaderTemplateCache}export function createJsonSecurityHeaders(){return new Headers(jsonSecurityHeadersTemplate())}export function secureSerializedJsonResponse(body,bodyLength,requestId,csrfCookie){if(bodyLength===undefined){const templates=_jsonMetadataHeaderTemplates??={};if(!requestId&&!csrfCookie)return new Response(body,templates.plain??={headers:jsonSecurityHeadersTemplate()});if(csrfCookie){const responseInit=requestId?templates.withCsrfAndRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:templates.withCsrf??={headers:new Headers(jsonSecurityHeadersTemplate())};responseInit.headers.set("Set-Cookie",csrfCookie);if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const responseInit=templates.withRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())};if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const templates=_jsonLengthHeaderTemplateCache??=new Map;let lengthTemplates=templates.get(bodyLength);if(!lengthTemplates&&templates.size<JSON_LENGTH_HEADER_CACHE_LIMIT){const headers=new Headers(jsonSecurityHeadersTemplate());headers.set("Content-Length",String(bodyLength));lengthTemplates={plain:{headers}};templates.set(bodyLength,lengthTemplates)}if(lengthTemplates){if(csrfCookie){const responseInit=requestId?lengthTemplates.withCsrfAndRequestId??={headers:new Headers(lengthTemplates.plain.headers)}:lengthTemplates.withCsrf??={headers:new Headers(lengthTemplates.plain.headers)};responseInit.headers.set("Set-Cookie",csrfCookie);if(requestId)responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}if(!requestId)return new Response(body,lengthTemplates.plain);const responseInit=lengthTemplates.withRequestId??={headers:new Headers(lengthTemplates.plain.headers)};responseInit.headers.set("X-Request-ID",requestId);return new Response(body,responseInit)}const uncached=_jsonUncachedLengthHeaderTemplates??={};const responseInit=csrfCookie?requestId?uncached.withCsrfAndRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:uncached.withCsrf??={headers:new Headers(jsonSecurityHeadersTemplate())}:requestId?uncached.withRequestId??={headers:new Headers(jsonSecurityHeadersTemplate())}:uncached.plain??={headers:new Headers(jsonSecurityHeadersTemplate())};responseInit.headers.set("Content-Length",String(bodyLength));if(requestId)responseInit.headers.set("X-Request-ID",requestId);if(csrfCookie)responseInit.headers.set("Set-Cookie",csrfCookie);return new Response(body,responseInit)}export function __resetSecurityHeadersCache(){_isProductionCache=undefined;_isDisabledCache=undefined;_cspCache=undefined;_headerTemplateCache=undefined;_jsonHeaderTemplateCache=undefined;_jsonMetadataHeaderTemplates=undefined;_jsonLengthHeaderTemplateCache=undefined;_jsonUncachedLengthHeaderTemplates=undefined}
@@ -1 +1 @@
1
- import process from"node:process";import{clientAddress as resolveClientAddress}from"@stacksjs/bun-router";import{config}from"@stacksjs/config";export function rateLimitScale(){const fromEnv=process.env.STACKS_RATE_LIMIT_SCALE,raw=fromEnv!==void 0&&fromEnv!==""?Number(fromEnv):config.security?.rateLimit?.scale,scale=typeof raw==="number"?raw:Number(raw);return Number.isFinite(scale)&&scale>0?scale:1}export function scaledLimit(max){return Math.max(1,Math.floor(max*rateLimitScale()))}export function trustedProxies(){const configured=config.security?.trustedProxies;if(!Array.isArray(configured))return;return configured.filter((entry)=>typeof entry==="string"&&entry.length>0)}export function clientAddress(req,options){if(options)return resolveClientAddress(req,options);const proxies=trustedProxies();return resolveClientAddress(req,proxies?{trustedProxies:proxies}:void 0)}export function cacheRedisConnection(cache=config.cache){const redis=cache?.drivers?.redis;if(cache?.driver!=="redis"||!redis)return null;const prefix=cache.prefix??"stacks";if(redis.url)return{url:redis.url,prefix};const protocol=redis.tls?"rediss":"redis",credentials=redis.username?`${encodeURIComponent(redis.username)}:${encodeURIComponent(redis.password??"")}@`:redis.password?`:${encodeURIComponent(redis.password)}@`:"",database=redis.database==null?"":`/${redis.database}`;return{url:`${protocol}://${credentials}${redis.host??"127.0.0.1"}:${redis.port??6379}${database}`,prefix}}let warnedSharedStore=!1;function warnSharedStoreOnce(error){if(warnedSharedStore)return;warnedSharedStore=!0;console.warn(`[router] rate limits fell back to this process's memory: the configured Redis cache is unreachable (${error instanceof Error?error.message:String(error)}). Limits are per process until it recovers.`)}export function fallbackStorage(shared,local){async function attempt(primary,secondary){try{return await primary()}catch(error){warnSharedStoreOnce(error);return secondary()}}return{increment:(key,windowMs)=>attempt(()=>shared.increment(key,windowMs),()=>local.increment(key,windowMs)),reset:(key)=>attempt(()=>shared.reset(key),()=>local.reset(key)),getCount:(key)=>attempt(()=>shared.getCount?.(key)??Promise.resolve(0),()=>local.getCount?.(key)??Promise.resolve(0)),dispose:()=>{shared.dispose?.();local.dispose?.()}}}let sharedStorage;export function sharedRateLimitStorage(){return sharedStorage??=(async()=>{const connection=cacheRedisConnection();if(!connection)return null;const[{RedisClient},{MemoryStorage,RedisStorage}]=await Promise.all([import("bun"),import("ts-rate-limiter")]),client=new RedisClient(connection.url),shared=new RedisStorage({client,keyPrefix:`${connection.prefix}:ratelimit:`});return fallbackStorage(shared,new MemoryStorage)})()}export function useRateLimitStorage(storage){sharedStorage=Promise.resolve(storage)}export function resetSharedRateLimitStorage(){sharedStorage=void 0;warnedSharedStore=!1}
1
+ import process from"node:process";import{clientAddress as resolveClientAddress}from"@stacksjs/bun-router";import{config}from"@stacksjs/config";export function rateLimitScale(){const fromEnv=process.env.STACKS_RATE_LIMIT_SCALE;const raw=fromEnv!==undefined&&fromEnv!==""?Number(fromEnv):config.security?.rateLimit?.scale;const scale=typeof raw==="number"?raw:Number(raw);return Number.isFinite(scale)&&scale>0?scale:1}export function scaledLimit(max){return Math.max(1,Math.floor(max*rateLimitScale()))}export function trustedProxies(){const configured=config.security?.trustedProxies;if(!Array.isArray(configured))return;return configured.filter((entry)=>typeof entry==="string"&&entry.length>0)}export function clientAddress(req,options){if(options)return resolveClientAddress(req,options);const proxies=trustedProxies();return resolveClientAddress(req,proxies?{trustedProxies:proxies}:undefined)}export function cacheRedisConnection(cache=config.cache){const redis=cache?.drivers?.redis;if(cache?.driver!=="redis"||!redis)return null;const prefix=cache.prefix??"stacks";if(redis.url)return{url:redis.url,prefix};const protocol=redis.tls?"rediss":"redis";const credentials=redis.username?`${encodeURIComponent(redis.username)}:${encodeURIComponent(redis.password??"")}@`:redis.password?`:${encodeURIComponent(redis.password)}@`:"";const database=redis.database==null?"":`/${redis.database}`;return{url:`${protocol}://${credentials}${redis.host??"127.0.0.1"}:${redis.port??6379}${database}`,prefix}}let warnedSharedStore=false;function warnSharedStoreOnce(error){if(warnedSharedStore)return;warnedSharedStore=true;console.warn(`[router] rate limits fell back to this process's memory: the configured Redis cache is unreachable (${error instanceof Error?error.message:String(error)}). Limits are per process until it recovers.`)}export function fallbackStorage(shared,local){async function attempt(primary,secondary){try{return await primary()}catch(error){warnSharedStoreOnce(error);return secondary()}}return{increment:(key,windowMs)=>attempt(()=>shared.increment(key,windowMs),()=>local.increment(key,windowMs)),reset:(key)=>attempt(()=>shared.reset(key),()=>local.reset(key)),getCount:(key)=>attempt(()=>shared.getCount?.(key)??Promise.resolve(0),()=>local.getCount?.(key)??Promise.resolve(0)),dispose:()=>{shared.dispose?.();local.dispose?.()}}}let sharedStorage;export function sharedRateLimitStorage(){return sharedStorage??=(async()=>{const connection=cacheRedisConnection();if(!connection)return null;const[{RedisClient},{MemoryStorage,RedisStorage}]=await Promise.all([import("bun"),import("ts-rate-limiter")]);const client=new RedisClient(connection.url);const shared=new RedisStorage({client,keyPrefix:`${connection.prefix}:ratelimit:`});return fallbackStorage(shared,new MemoryStorage)})()}export function useRateLimitStorage(storage){sharedStorage=Promise.resolve(storage)}export function resetSharedRateLimitStorage(){sharedStorage=undefined;warnedSharedStore=false}
@@ -1 +1 @@
1
- import process from"node:process";import{createSessionStore}from"@stacksjs/bun-router";import{EncryptedSessionStore}from"./encrypted-session-store";export function createStacksSessionStore(config){const base=createSessionStore(config);if(!resolveEncryptionMode(config.encrypt))return base;const appKey=config.appKey??process.env.APP_KEY;if(!appKey||appKey.length<16)throw Error("[session] createStacksSessionStore: encryption requested but APP_KEY is missing or too short "+"(need \u226516 chars). Either set APP_KEY in env, pass `appKey` in config, or set `encrypt: false` to opt out.");return new EncryptedSessionStore(base,{appKey})}function resolveEncryptionMode(mode){if(mode===!0)return!0;if(mode===!1)return!1;return(process.env.APP_ENV??process.env.NODE_ENV??"").toLowerCase()==="production"}export{DatabaseSessionStore,FileSessionStore,MemorySessionStore,RedisSessionStore,createSessionStore}from"@stacksjs/bun-router";
1
+ import process from"node:process";import{createSessionStore}from"@stacksjs/bun-router";import{EncryptedSessionStore}from"./encrypted-session-store";export function createStacksSessionStore(config){const base=createSessionStore(config);const shouldEncrypt=resolveEncryptionMode(config.encrypt);if(!shouldEncrypt)return base;const appKey=config.appKey??process.env.APP_KEY;if(!appKey||appKey.length<16){throw new Error("[session] createStacksSessionStore: encryption requested but APP_KEY is missing or too short "+"(need ≥16 chars). Either set APP_KEY in env, pass `appKey` in config, or set `encrypt: false` to opt out.")}return new EncryptedSessionStore(base,{appKey})}function resolveEncryptionMode(mode){if(mode===true)return true;if(mode===false)return false;const env=(process.env.APP_ENV??process.env.NODE_ENV??"").toLowerCase();return env==="production"}export{DatabaseSessionStore,FileSessionStore,MemorySessionStore,RedisSessionStore,createSessionStore}from"@stacksjs/bun-router";
@@ -1 +1 @@
1
- import{Buffer}from"node:buffer";import process from"node:process";import{url as buildUrl}from"./stacks-router";const SIGNATURE_PARAM="signature",EXPIRES_PARAM="expires";function getSigningSecret(){const secret=process.env.APP_KEY||process.env.STACKS_SIGNED_URL_SECRET;if(!secret||secret.length<16)throw Error("[router] signed URLs require APP_KEY (\u2265 16 chars) or STACKS_SIGNED_URL_SECRET. "+"Run `./buddy key:generate` or set the env var.");return secret}function hmacHex(payload,secret){return new Bun.CryptoHasher("sha256",secret).update(payload).digest("hex")}let nativeTimingSafeEqual;function timingSafeEqual(a,b){nativeTimingSafeEqual??=process.getBuiltinModule("node:crypto").timingSafeEqual;return nativeTimingSafeEqual(a,b)}function safeEqualHex(a,b){const ba=Buffer.from(a.toLowerCase(),"hex"),bb=Buffer.from(b.toLowerCase(),"hex");if(ba.length!==bb.length)return!1;return timingSafeEqual(ba,bb)}function stripSignatureParam(input){const u=new URL(input.toString());u.searchParams.delete(SIGNATURE_PARAM);return u}function buildSignaturePayload(input){const stripped=stripSignatureParam(input);stripped.searchParams.sort();return stripped.toString()}export function signUrl(input,options={}){const secret=getSigningSecret(),url=input.startsWith("http")?new URL(input):new URL(input.startsWith("/")?input:`/${input}`,configuredAppOrigin()??"https://localhost");if(options.ttl!==void 0&&options.expiresAt!==void 0)warnOnce("dual-expiry","[router] signUrl: both `ttl` and `expiresAt` provided - using `ttl`.");if(options.ttl!==void 0)url.searchParams.set(EXPIRES_PARAM,String(Math.floor(Date.now()/1000)+options.ttl));else if(options.expiresAt!==void 0)url.searchParams.set(EXPIRES_PARAM,String(Math.floor(options.expiresAt)));const payload=buildSignaturePayload(url);url.searchParams.set(SIGNATURE_PARAM,hmacHex(payload,secret));return url.toString()}let _warnedKeys;function warnOnce(key,message){if(_warnedKeys?.has(key))return;(_warnedKeys??=new Set).add(key);console.warn(message)}export function signedUrl(routeName,params={},options={}){return signUrl(buildUrl(routeName,params),options)}function configuredAppOrigin(){const appUrl=process.env.APP_URL;if(!appUrl)return null;try{return new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(appUrl)?appUrl:`https://${appUrl}`).origin}catch{return null}}export function verifySignedUrl(input){const url=typeof input==="string"?new URL(input,configuredAppOrigin()??"https://localhost"):input,presented=url.searchParams.get(SIGNATURE_PARAM);if(!presented)return{valid:!1,reason:"missing-signature"};const expiresRaw=url.searchParams.get(EXPIRES_PARAM);if(expiresRaw!==null){const expires=Number.parseInt(expiresRaw,10);if(!Number.isFinite(expires)||Date.now()/1000>expires)return{valid:!1,reason:"expired"}}try{const secret=getSigningSecret();if(safeEqualHex(presented,hmacHex(buildSignaturePayload(url),secret)))return{valid:!0};const appOrigin=configuredAppOrigin();if(appOrigin&&appOrigin!==url.origin){const asServed=new URL(`${url.pathname}${url.search}`,appOrigin);if(safeEqualHex(presented,hmacHex(buildSignaturePayload(asServed),secret)))return{valid:!0}}return{valid:!1,reason:"invalid-signature"}}catch{return{valid:!1,reason:"invalid-signature"}}}export async function verifySignedUrlMiddleware(req){const result=verifySignedUrl(req.url);if(result.valid)return;const status=result.reason==="expired"?410:401;throw Response.json({error:result.reason},{status})}
1
+ import{Buffer}from"node:buffer";import process from"node:process";import{url as buildUrl}from"./stacks-router";const SIGNATURE_PARAM="signature";const EXPIRES_PARAM="expires";function getSigningSecret(){const secret=process.env.APP_KEY||process.env.STACKS_SIGNED_URL_SECRET;if(!secret||secret.length<16){throw new Error("[router] signed URLs require APP_KEY (≥ 16 chars) or STACKS_SIGNED_URL_SECRET. "+"Run `./buddy key:generate` or set the env var.")}return secret}function hmacHex(payload,secret){return new Bun.CryptoHasher("sha256",secret).update(payload).digest("hex")}let nativeTimingSafeEqual;function timingSafeEqual(a,b){nativeTimingSafeEqual??=process.getBuiltinModule("node:crypto").timingSafeEqual;return nativeTimingSafeEqual(a,b)}function safeEqualHex(a,b){const ba=Buffer.from(a.toLowerCase(),"hex");const bb=Buffer.from(b.toLowerCase(),"hex");if(ba.length!==bb.length)return false;return timingSafeEqual(ba,bb)}function stripSignatureParam(input){const u=new URL(input.toString());u.searchParams.delete(SIGNATURE_PARAM);return u}function buildSignaturePayload(input){const stripped=stripSignatureParam(input);stripped.searchParams.sort();return stripped.toString()}export function signUrl(input,options={}){const secret=getSigningSecret();const url=input.startsWith("http")?new URL(input):new URL(input.startsWith("/")?input:`/${input}`,configuredAppOrigin()??"https://localhost");if(options.ttl!==undefined&&options.expiresAt!==undefined){warnOnce("dual-expiry","[router] signUrl: both `ttl` and `expiresAt` provided - using `ttl`.")}if(options.ttl!==undefined){url.searchParams.set(EXPIRES_PARAM,String(Math.floor(Date.now()/1000)+options.ttl))}else if(options.expiresAt!==undefined){url.searchParams.set(EXPIRES_PARAM,String(Math.floor(options.expiresAt)))}const payload=buildSignaturePayload(url);url.searchParams.set(SIGNATURE_PARAM,hmacHex(payload,secret));return url.toString()}let _warnedKeys;function warnOnce(key,message){if(_warnedKeys?.has(key))return;const warnedKeys=_warnedKeys??=new Set;warnedKeys.add(key);console.warn(message)}export function signedUrl(routeName,params={},options={}){return signUrl(buildUrl(routeName,params),options)}function configuredAppOrigin(){const appUrl=process.env.APP_URL;if(!appUrl)return null;try{return new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(appUrl)?appUrl:`https://${appUrl}`).origin}catch{return null}}export function verifySignedUrl(input){const url=typeof input==="string"?new URL(input,configuredAppOrigin()??"https://localhost"):input;const presented=url.searchParams.get(SIGNATURE_PARAM);if(!presented)return{valid:false,reason:"missing-signature"};const expiresRaw=url.searchParams.get(EXPIRES_PARAM);if(expiresRaw!==null){const expires=Number.parseInt(expiresRaw,10);if(!Number.isFinite(expires)||Date.now()/1000>expires){return{valid:false,reason:"expired"}}}try{const secret=getSigningSecret();if(safeEqualHex(presented,hmacHex(buildSignaturePayload(url),secret)))return{valid:true};const appOrigin=configuredAppOrigin();if(appOrigin&&appOrigin!==url.origin){const asServed=new URL(`${url.pathname}${url.search}`,appOrigin);if(safeEqualHex(presented,hmacHex(buildSignaturePayload(asServed),secret)))return{valid:true}}return{valid:false,reason:"invalid-signature"}}catch{return{valid:false,reason:"invalid-signature"}}}export async function verifySignedUrlMiddleware(req){const result=verifySignedUrl(req.url);if(result.valid)return;const status=result.reason==="expired"?410:401;throw Response.json({error:result.reason},{status})}
@@ -1,6 +1,6 @@
1
- var {require}=import.meta;import{applyRequestEnhancements,applyResponseCompression,ENRICHED_NOT_FOUND_RESPONSE,response,Router,runWithRequest as runWithBunRouterRequest}from"@stacksjs/bun-router/runtime";import"./request-augmentation";import{flushRequestCaptures,observeHttpRequest,requestCaptureEnabled}from"./request-capture";import process from"node:process";import{Buffer}from"node:buffer";import{existsSync,lstatSync,statSync}from"node:fs";import{isAbsolute,relative,sep}from"node:path";import{log,report}from"@stacksjs/logging/runtime";import{appPath,frameworkPath,projectPath,storagePath}from"@stacksjs/path/project";import{resolveModulePath}from"@stacksjs/path/module-resolution";const DATABASE_QUERY_TRACKER_KEY=Symbol.for("stacks.database.queryTracker"),queryTrackerGlobal=globalThis,loadQueryTracker=(...args)=>{const{trackQuery}=require("./query-tracking");queryTrackerGlobal[DATABASE_QUERY_TRACKER_KEY]=trackQuery;trackQuery(...args)};queryTrackerGlobal[DATABASE_QUERY_TRACKER_KEY]=loadQueryTracker;const ROUTER_INSTANCES_KEY=Symbol.for("@stacksjs/router:loaded-instances"),loadedRouterInstances=globalThis[ROUTER_INSTANCES_KEY]??=new Set;loadedRouterInstances.add(import.meta.path);const MULTI_INSTANCE_WARNED_KEY=Symbol.for("@stacksjs/router:multi-instance-warned"),bootHooks=[];let bootHooksRun=!1;export async function runBootHooks(){if(bootHooksRun)return;bootHooksRun=!0;for(const hook of bootHooks)try{await hook.run()}catch(error){log.error(`[router] boot hook "${hook.name}" failed:`,error)}}export function resetBootHooks(){bootHooks.length=0;bootHooksRun=!1}const SHUTDOWN_HOOKS_KEY=Symbol.for("@stacksjs/router:shutdown-hooks");function shutdownHooks(){return globalThis[SHUTDOWN_HOOKS_KEY]??={hooks:[]}}export function runShutdownHooks(){const state=shutdownHooks();state.running??=Promise.all(state.hooks.map(async(hook)=>{try{await hook.run()}catch(error){await log.error(`[router] shutdown hook "${hook.name}" failed:`,error)}})).then(()=>{});return state.running}export function resetShutdownHooks(){const state=shutdownHooks();state.hooks.length=0;state.running=void 0}export function warnOnMultipleRouterInstances(){if(loadedRouterInstances.size<=1)return!1;const g=globalThis;if(!g[MULTI_INSTANCE_WARNED_KEY]){g[MULTI_INSTANCE_WARNED_KEY]=!0;const paths=[...loadedRouterInstances].map((p)=>` - ${p}`).join(`
2
- `);log.warn(`${loadedRouterInstances.size} distinct @stacksjs/router modules loaded in one process; they now share one route table (stacksjs/stacks#1982) so routing still works, but this is a duplicated install worth fixing. It usually means an app vendors storage/framework/core AND installs the published @stacksjs/* dist, and a tsconfig \`paths\` mapping (\`@stacksjs/* -> ./*/src\`) splits module resolution between core files and root files. See stacksjs/stacks#1975.
3
- Loaded instances:
4
- ${paths}`)}return!0}let __defaultsPkgRoot,__defaultsPathCache;function resolveDefaultsPath(rel){const cached=__defaultsPathCache?.get(rel);if(cached!==void 0)return cached;if(rel.startsWith("app/")){const published=appPath(rel.slice(4));if(existsSync(published)){(__defaultsPathCache??=new Map).set(rel,published);return published}}const vendored=storagePath(`framework/defaults/${rel}`);let resolved;if(existsSync(vendored))resolved=vendored;else{if(__defaultsPkgRoot===void 0)try{const pkgJson=Bun.resolveSync("@stacksjs/defaults/package.json",process.cwd());__defaultsPkgRoot=pkgJson.slice(0,pkgJson.lastIndexOf("/"))}catch{__defaultsPkgRoot=null}resolved=__defaultsPkgRoot?`${__defaultsPkgRoot}/${rel}`:vendored}(__defaultsPathCache??=new Map).set(rel,resolved);return resolved}const NATIVE_ROUTE_PARAM=/^\{[A-Z_$][\w$]*\}$/i;function isNativeRouteMethod(method){return method==="GET"||method==="POST"||method==="PUT"||method==="PATCH"||method==="DELETE"||method==="OPTIONS"||method==="HEAD"}function hasNativeCompatiblePath(path){if(path==="*")return!0;const segments=path.split("/");for(let index=0;index<segments.length;index++){const segment=segments[index];if(segment===""||NATIVE_ROUTE_PARAM.test(segment))continue;if(segment==="*"&&index===segments.length-1)continue;if(segment.includes("{")||segment.includes(":")||segment.includes("*"))return!1}return!0}export function shouldUseNativeRoutesByDefault(routes){let hasEligibleRoute=!1;for(const route of routes){if(!isNativeRouteMethod(route.method)||route.handler instanceof Response)continue;hasEligibleRoute=!0;if(route.nativeDispatch===!1||route.domain||route.constraints&&Object.keys(route.constraints).length>0||!hasNativeCompatiblePath(route.path))return!1}return hasEligibleRoute}import{runWithRequestArgument,runWithRequestArguments,setAmbientRequestContext}from"./request-context";import{isApiRequest,JSON_CONTENT_TYPE}from"./api-shape";import{applySecurityHeaders,createJsonSecurityHeaders,secureSerializedJsonResponse}from"./security-headers";import{isCursorPaginator,isPaginator,isSimplePaginator}from"@stacksjs/pagination";let errorHandlerModule,errorHandlerModuleLoad;async function loadErrorHandlerModule(){return errorHandlerModule??=await(errorHandlerModuleLoad??=import("./error-handler"))}async function createErrorResponse(...args){return(await loadErrorHandlerModule()).createErrorResponse(...args)}async function createMiddlewareErrorResponse(...args){return(await loadErrorHandlerModule()).createMiddlewareErrorResponse(...args)}function bindAsyncRouteHandler(handler){return(req,preparedBaseResult,hasPreparedBaseResult=!1)=>runWithRequestArguments(req,handler,req,preparedBaseResult,hasPreparedBaseResult)}const stacksRouteHandlers=new WeakSet;function rememberStacksRouteHandler(handler){stacksRouteHandlers.add(handler);return handler}function invokeInlineHandler(req,handler,_unused){const result=handler(req);if(result instanceof Promise)return result.then((value)=>formatResult(value,req));return formatResult(result,req)}const STATIC_RESPONSE_METHODS=new Set(["GET","POST","PUT","PATCH","DELETE","OPTIONS"]),CSRF_DEFAULT=0,CSRF_SKIPPED=1,CSRF_REQUIRED=2,ROUTE_ACCEPTS_CSRF=1,ROUTE_MAY_HAVE_BODY=2,ROUTE_RENDERS_CSRF=4,ROUTE_SEEDS_CSRF=8,ROUTE_FORCES_JSON=16,ROUTE_ACTION_SKIPS_CSRF=32,routeStateRegistries=new Set,clearedRouteKeysByRegistry=new WeakMap;let routeAdmission,withheldRoutes=[];export async function withRouteAdmission(admit,register){const previous=routeAdmission,previousWithheld=withheldRoutes;routeAdmission=admit;withheldRoutes=[];try{await register();return withheldRoutes}finally{routeAdmission=previous;withheldRoutes=previousWithheld}}function rateLimitWindowToSeconds(window){if(typeof window==="number"){if(!Number.isFinite(window)||window<=0)throw Error(`[Router] .rateLimit(): window must be a positive number of seconds, got ${window}`);return Math.floor(window)}switch(window){case"second":return 1;case"minute":return 60;case"hour":return 3600;case"day":return 86400;default:throw Error(`[Router] .rateLimit(): unknown period '${String(window)}'`)}}class BoundedMap{max;map;constructor(max){this.max=max}get(key){return this.map?.get(key)}has(key){return this.map?.has(key)??!1}set(key,value){const map=this.map??=new Map;if(map.has(key))map.delete(key);map.set(key,value);if(map.size>this.max){const oldest=map.keys().next().value;if(oldest!==void 0)map.delete(oldest)}return this}delete(key){return this.map?.delete(key)??!1}clear(){this.map=void 0}get size(){return this.map?.size??0}}function isExposeRoutesAuthorized(req){const flag=process.env.STACKS_EXPOSE_ROUTES??"";if(!flag)return!((process.env.APP_ENV??"").toLowerCase()==="production"||process.env.NODE_ENV==="production");if(flag==="1")return!((process.env.APP_ENV??"").toLowerCase()==="production"||process.env.NODE_ENV==="production");const url=new URL(req.url),submitted=req.headers.get("x-stacks-routes-token")||req.headers.get("X-Stacks-Routes-Token")||url.searchParams.get("token")||"";if(typeof submitted!=="string"||submitted.length===0||submitted.length!==flag.length)return!1;try{const encoder=new TextEncoder;return crypto.timingSafeEqual(encoder.encode(submitted),encoder.encode(flag))}catch{return!1}}let corsHeaderApplierCache={},compressionApplierCache={};function applyCorsIfConfigured(req,response){if(!req._corsConfig||!response)return response;const cache=corsHeaderApplierCache;if(!cache.apply)return loadAndApplyCorsHeaders(req,response,cache);try{return cache.apply(req,response,req._corsConfig)}catch(err){log.warn("[router] CORS header injection failed",{error:err});return response}}async function loadAndApplyCorsHeaders(req,response,cache){try{return(cache.apply??=(await import(resolveDefaultsPath("app/Middleware/Cors.ts"))).applyCorsHeaders)(req,response,req._corsConfig)}catch(err){log.warn("[router] CORS header injection failed",{error:err});return response}}const ACTION_CACHE_MAX=5000,actionSkipsCsrfCache=new BoundedMap(ACTION_CACHE_MAX),routeHandlerKeyRegistry=new BoundedMap(ACTION_CACHE_MAX);let routeActionRegistry;const CSRF_SEEDED_BY_HANDLE_REQUEST=Symbol.for("stacks.router.csrfSeededByHandleRequest"),FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND=Symbol("stacks.router.frameworkResponseBodySizeUpperBound"),NATIVE_DIRECT_ROUTE_REQUEST=Symbol("stacks.router.nativeDirectRouteRequest"),CSRF_SECURE_TRANSPORT=Symbol.for("@stacksjs/router:csrf-secure-transport"),secureNativeRouteRouters=new WeakSet,csrfEnabledNativeRouteRouters=new WeakSet,routersWithoutRequestContext=new WeakSet,EMPTY_MIDDLEWARE_TIMINGS=[],EMPTY_MIDDLEWARE_ENTRIES=[],CSRF_ONLY_MIDDLEWARE=["csrf"];let resolvedMiddlewareEntryCache,resolvedCsrfOnlyMiddleware;export async function withFallbackRouteNames(register){const applicationNames=new Map(namedRouteRegistry);try{await register()}finally{if(applicationNames.size){const registry=namedRouteRegistry??=new Map;for(const[name,definition]of applicationNames)registry.set(name,definition)}}}let namedRouteRegistry;const REDIRECT_STATUSES=new Set([301,302,303,307,308]);let redirectRouteRegistry;function compileNamedRoute(path){const paramNames=extractRouteParamNames(path),colonRegex=new Map;for(const name of paramNames)colonRegex.set(name,new RegExp(`(^|/):${name}(?=$|/)`,"g"));const optionalNames=[...new Set([...path.matchAll(/\{(\w+)\?\}/g)].map((m)=>m[1]))];return{path,paramNames,optionalNames,colonRegex}}function extractRouteParamNames(routePath){const names=new Set;for(const m of routePath.matchAll(/\{(\w+)\}/g))if(m[1])names.add(m[1]);for(const m of routePath.matchAll(/(?:^|\/):(\w+)(?=$|\/)/g))if(m[1])names.add(m[1]);return[...names]}function braceParams(path){return path.includes(":")?path.replace(/(^|\/):(\w+)(?=$|\/)/g,"$1{$2}"):path}export function url(routeName,params={}){const named=namedRouteRegistry?.get(routeName);if(!named){const availableRoutes=namedRouteRegistry?[...namedRouteRegistry.keys()].join(", "):"";throw Error(`Route '${routeName}' is not defined. Available routes: ${availableRoutes}`)}const missing=named.paramNames.filter((name)=>!(name in params)||params[name]===void 0);if(missing.length>0)throw Error(`url('${routeName}'): missing required path param${missing.length>1?"s":""} [${missing.join(", ")}] for path '${named.path}'. Pass them as the second argument: url('${routeName}', { ${named.paramNames.join(", ")} })`);let appUrl;try{appUrl=process.env.APP_URL||"https://localhost"}catch{appUrl="https://localhost"}appUrl=appUrl.replace(/\/$/,"");if(!appUrl.startsWith("http"))appUrl=`https://${appUrl}`;let resolvedPath=named.path;const queryParams={};for(const[key,value]of Object.entries(params)){if(value===void 0)continue;const curly=`{${key}}`,optional=`{${key}?}`;if(resolvedPath.includes(curly))resolvedPath=resolvedPath.replaceAll(curly,encodeURIComponent(String(value)));else if(resolvedPath.includes(optional))resolvedPath=resolvedPath.replaceAll(optional,encodeURIComponent(String(value)));else{const re=named.colonRegex.get(key);if(re&&re.test(resolvedPath)){re.lastIndex=0;resolvedPath=resolvedPath.replace(re,`$1${encodeURIComponent(String(value))}`)}else queryParams[key]=String(value)}}for(const name of named.optionalNames)resolvedPath=resolvedPath.replaceAll(`/{${name}?}`,"").replaceAll(`{${name}?}`,"");if(resolvedPath==="")resolvedPath="/";const queryString=Object.keys(queryParams).length>0?`?${new URLSearchParams(queryParams).toString()}`:"";return`${appUrl}${resolvedPath}${queryString}`}export function routeParams(routeName){const named=namedRouteRegistry?.get(routeName);return named?[...named.paramNames]:[]}export function listNamedRoutes(){const out={};if(namedRouteRegistry)for(const[name,named]of namedRouteRegistry)out[name]=named.path;return out}export function listRedirectRoutes(){return redirectRouteRegistry?[...redirectRouteRegistry.values()]:[]}export function listRegisteredRoutes(){const namesByPath=namedRouteRegistry?new Map:void 0;if(namesByPath&&namedRouteRegistry){for(const[name,named]of namedRouteRegistry)if(!namesByPath.has(named.path))namesByPath.set(named.path,name)}const out=[],seen=new Set;for(const registry of routeStateRegistries)for(const key of registry.keys()){if(seen.has(key))continue;seen.add(key);const idx=key.indexOf(":");if(idx===-1)continue;const method=key.slice(0,idx),path=key.slice(idx+1),routeName=namesByPath?.get(path);out.push({method,path,name:routeName,handler:routeHandlerKeyRegistry.get(key),action:routeActionRegistry?.get(key),middleware:registry.get(key)?.middleware})}return out.sort((a,b)=>a.path.localeCompare(b.path))}const MIDDLEWARE_TIMEOUT_MS=30000;let _debugLoggingCache;function isDebugLogging(){if(_debugLoggingCache===void 0){const level=(process.env.LOG_LEVEL||"info").toLowerCase();_debugLoggingCache=level!=="info"&&level!=="warn"&&level!=="error"}return _debugLoggingCache}const DEFAULT_MIDDLEWARE_PRIORITY=10;let _warnedInvalidPriorities;function warnInvalidMiddlewarePriority(name,raw){const key=`${name}:${String(raw)}`;if(_warnedInvalidPriorities?.has(key))return;(_warnedInvalidPriorities??=new Set).add(key);log.warn(`[Router] Middleware '${name}' declared an invalid priority (${String(raw)}). Priorities must be a finite non-negative number; falling back to default ${DEFAULT_MIDDLEWARE_PRIORITY}.`)}function adaptMiddlewareForBunRouter(middleware){if(middleware&&typeof middleware==="object"&&typeof middleware.toRouterHandler==="function")return middleware.toRouterHandler();if(middleware&&typeof middleware==="object"&&typeof middleware.handle==="function"&&typeof middleware!=="function"){const handle=middleware.handle.bind(middleware);return async(req,next)=>{try{await handle(req)}catch(thrown){if(thrown instanceof Response)return thrown;throw thrown}return next()}}return middleware}let middlewareCache,middlewareAliasesPromise=null;async function getMiddlewareAliases(){if(middlewareAliasesPromise)return middlewareAliasesPromise;middlewareAliasesPromise=(async()=>{const merged={};for(const load of[()=>import(resolveDefaultsPath("app/Middleware.ts")),()=>import(appPath("Middleware.ts"))])try{const module=await load();Object.assign(merged,module.default??{})}catch{}return merged})();return middlewareAliasesPromise}const PASCAL_SPLIT_REGEX=/[-_\s]+/;let pascalCaseCache;function toPascalCase(input){if(!input)return input;const cached=pascalCaseCache?.get(input);if(cached!==void 0)return cached;const out=input.split(PASCAL_SPLIT_REGEX).filter(Boolean).map((part)=>part.charAt(0).toUpperCase()+part.slice(1)).join("");(pascalCaseCache??=new Map).set(input,out);return out}async function resolveMiddlewareName(name){const resolved=(await getMiddlewareAliases())[name]||toPascalCase(name);log.debug(`[middleware] Resolved: ${name} \u2192 ${resolved}`);return resolved}let middlewareRegistryPromise=null;async function getMiddlewareRegistry(){if(middlewareRegistryPromise)return middlewareRegistryPromise;middlewareRegistryPromise=(async()=>{const dir=storagePath("framework/auto-imports"),registryPath=`${dir}/middleware.ts`;if(!existsSync(registryPath))return null;const module=await import(registryPath);if(!module.middleware)throw Error(`Invalid middleware registry: ${registryPath}`);return Object.fromEntries(Object.entries(module.middleware).map(([name,file])=>[name,resolveModulePath(file,dir)]))})();return middlewareRegistryPromise}async function loadMiddleware(name){const cachedMiddleware=middlewareCache??=new Map;if(cachedMiddleware.has(name))return cachedMiddleware.get(name)??null;const className=await resolveMiddlewareName(name),registered=(await getMiddlewareRegistry())?.[className];if(registered)try{const handler=(await import(registered)).default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${registered}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){log.error(`[Router] Failed to load middleware '${name}' from ${registered}:`,err);return null}let userPathError;try{const userPath=appPath(`Middleware/${className}.ts`),handler=(await import(userPath)).default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${userPath}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){userPathError=err}try{const defaultPath=resolveDefaultsPath(`app/Middleware/${className}.ts`),handler=(await import(defaultPath)).default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${defaultPath}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){const userMsg=userPathError instanceof Error?userPathError.message:String(userPathError);log.error(`[Router] Failed to load middleware '${name}' (resolved to '${className}'). app/Middleware: ${userMsg}; defaults:`,err);return null}}export async function middlewareAliases(){return{...await getMiddlewareAliases()}}export async function loadMiddlewareHandlers(){const aliases=await getMiddlewareAliases(),generated=await getMiddlewareRegistry(),references=new Set([...Object.keys(aliases),...Object.values(aliases),...Object.keys(generated??{})]),handlers={};await Promise.all([...references].map(async(reference)=>{const handler=await loadMiddleware(reference);if(handler)handlers[reference]=handler}));return handlers}let negatedMiddlewareCache,routerHttpErrorModule;function isShortCircuit(thrown){if(thrown instanceof Response)return!0;return typeof thrown==="object"&&thrown!==null&&(("status"in thrown)||("statusCode"in thrown))}function negateMiddleware(name,inner,cache){const cached=cache.get(name);if(cached)return cached;const negated={priority:inner.priority,async handle(req){try{await inner.handle(req)}catch(thrown){if(isShortCircuit(thrown))return;throw thrown}const{HttpError}=routerHttpErrorModule??=await import("@stacksjs/error-handling/http-error");throw new HttpError(403,`Access denied. This route requires "${name}" not to apply.`)}};cache.set(name,negated);return negated}function loadParsedMiddleware(parsed){const negatedCache=parsed.negated?negatedMiddlewareCache??=new Map:void 0,cached=middlewareCache?.get(parsed.name);if(cached!==void 0)return cached&&negatedCache?negateMiddleware(parsed.name,cached,negatedCache):cached;return loadMiddleware(parsed.name).then((handler)=>handler&&negatedCache?negateMiddleware(parsed.name,handler,negatedCache):handler)}export function clearMiddlewareCache(){corsHeaderApplierCache={};compressionApplierCache={};middlewareCache=void 0;negatedMiddlewareCache=void 0;resolvedMiddlewareEntryCache=void 0;resolvedCsrfOnlyMiddleware=void 0;parsedMiddlewareCache=void 0;middlewareAliasesPromise=null;middlewareRegistryPromise=null;actionRegistryPromise=null;actionSkipsCsrfCache.clear();routeHandlerKeyRegistry.clear();routeActionRegistry=void 0;clearCsrfModuleCache()}export function installMiddlewareHotReload(){if(process.env.APP_ENV==="production"||process.env.NODE_ENV==="production")return()=>{};let fsWatchers=[];(async()=>{try{const fs=await import("node:fs"),targets=[appPath("Middleware"),appPath("Middleware.ts")];for(const target of targets)try{if(!fs.existsSync(target))continue;const w=fs.watch(target,{recursive:!0},()=>{log.debug("[middleware] hot-reload: clearing cache");clearMiddlewareCache()});fsWatchers.push(w)}catch{}}catch{}})();return()=>{for(const w of fsWatchers)try{w.close()}catch{}fsWatchers=[]}}export function clearRouteMiddlewareRegistry(){for(const registry of routeStateRegistries){const registeredKeys=clearedRouteKeysByRegistry.get(registry)??new Set;for(const routeKey of registry.keys())registeredKeys.add(routeKey);clearedRouteKeysByRegistry.set(registry,registeredKeys);for(const state of registry.values())if(state.middleware)state.middleware.length=0;registry.clear()}routeStateRegistries.clear()}let routeApiResponseRegistry,parsedMiddlewareCache;function parseMiddlewareEntry(middleware){const cache=parsedMiddlewareCache??=new Map;let parsed=cache.get(middleware);if(!parsed){parsed=parseMiddlewareEntryUncached(middleware).then((resolved)=>{cache.set(middleware,resolved);return resolved},(error)=>{cache.delete(middleware);throw error});cache.set(middleware,parsed)}return parsed}async function parseMiddlewareEntryUncached(middleware){const timingName=middleware.replace(/[^A-Za-z0-9_-]/g,"_").slice(0,32),negated=middleware.startsWith("!"),bare=negated?middleware.slice(1):middleware,aliases=await getMiddlewareAliases();if(Object.hasOwn(aliases,bare))return{name:bare,negated,timingName};const colonIndex=bare.indexOf(":");if(colonIndex===-1)return{name:bare,negated,timingName};return{name:bare.substring(0,colonIndex),negated,timingName,params:bare.substring(colonIndex+1)}}export async function findUnresolvableRouteMiddleware(){const usage=new Map;for(const registry of routeStateRegistries)for(const[routeKey,state]of registry){const entries=state.middleware;if(!entries)continue;for(const entry of entries){const pending=parseMiddlewareEntry(entry),parsed=pending instanceof Promise?await pending:pending,alias=parsed.negated?`!${parsed.name}`:parsed.name,seen=usage.get(alias)??{parsed,routes:[]};seen.routes.push(routeKey);usage.set(alias,seen)}}if(!usage.has("csrf"))usage.set("csrf",{parsed:{name:"csrf",negated:!1,timingName:"csrf"},routes:["(auto-injected on POST/PUT/PATCH/DELETE)"]});const unresolvable=[];for(const[alias,{parsed,routes}]of usage){const handler=await loadParsedMiddleware(parsed);if(!handler||typeof handler.handle!=="function")unresolvable.push({alias,routes})}return unresolvable}export async function assertRouteMiddlewareResolvable(){const unresolvable=await findUnresolvableRouteMiddleware();if(unresolvable.length===0)return;const detail=unresolvable.map((u)=>`"${u.alias}" (used by ${u.routes.join(", ")})`).join("; ");throw Error(`[Router] Unresolvable middleware alias(es): ${detail}. Check the alias map in app/Middleware.ts or add app/Middleware/<Class>.ts.`)}function applyRequestedResponseHeaders(req,headers){const requested=req._responseHeaders;if(!requested||typeof requested!=="object")return;for(const[name,value]of Object.entries(requested))if(typeof value==="string")headers.set(name,value)}function runAfterResponse(req,status,durationMs){const after=req._afterResponse;if(!Array.isArray(after))return;for(const callback of after)try{if(typeof callback==="function")callback({status,durationMs})}catch{}}function elapsedSinceStart(req){const startNs=req._startNs;return startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null}function finishSynchronousResult(req,response,csrfHandledByOuter,routeSeedsCsrf){const frameworkMetadataApplied=typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number";if(response.status>=400||req._corsConfig||req._compress===!0||req._startNs!=null||Array.isArray(req._afterResponse)||req._responseHeaders)return;if(frameworkMetadataApplied&&!routeSeedsCsrf)return response;let finalized=response;if(routeSeedsCsrf&&!csrfHandledByOuter&&req[CSRF_SEEDED_BY_HANDLE_REQUEST]!==!0){const mod=loadCsrfModule();if(mod instanceof Promise)return;if(mod)finalized=mod.seedCsrfCookieIfMissing(req,finalized,req._csrfToken,frameworkMetadataApplied)}if(!frameworkMetadataApplied)try{const requestId=req._requestId;if(requestId)finalized.headers.set("X-Request-ID",requestId);applySecurityHeaders(finalized.headers)}catch{return}return finalized}function routeCapabilityFlags(routeKey,handler,csrfEnabled){const routeMethod=routeKey.slice(0,routeKey.indexOf(":")).toUpperCase(),action=isRouterAction(handler)?handler:void 0,forcesJson=routeApiResponseRegistry?.has(routeKey)===!0||action?.apiResponse===!0;let flags=0;if(csrfEnabled&&(routeMethod==="POST"||routeMethod==="PUT"||routeMethod==="PATCH"||routeMethod==="DELETE"))flags|=ROUTE_ACCEPTS_CSRF;if(routeMethod!=="GET"&&routeMethod!=="HEAD")flags|=ROUTE_MAY_HAVE_BODY;if(csrfEnabled&&!forcesJson&&(routeMethod==="GET"||routeMethod==="HEAD"))flags|=ROUTE_RENDERS_CSRF;if(csrfEnabled&&(routeMethod==="GET"||routeMethod==="HEAD"||routeMethod==="OPTIONS"))flags|=ROUTE_SEEDS_CSRF;if(forcesJson)flags|=ROUTE_FORCES_JSON;if(action&&(action.skipCsrf===!0||action.csrf===!1))flags|=ROUTE_ACTION_SKIPS_CSRF;return flags}let routeRateLimitModule;function createMiddlewareHandler(router,routeStates,routeKey,handler,csrfEnabled=!0){const routeState=routeStates.get(routeKey),routeFlags=routeCapabilityFlags(routeKey,handler,csrfEnabled),handlerKey=typeof handler==="string"?handler:void 0,synchronousInlineHandler=typeof handler==="function"&&handler.constructor.name!=="AsyncFunction"?handler:void 0,asynchronousInlineHandler=typeof handler==="function"&&handler.constructor.name==="AsyncFunction"?handler:void 0,wrappedBase=typeof handler==="function"?void 0:wrapHandler(handler,!0,routeKey),handleAsyncInContext=async(req,preparedBaseResult,hasPreparedBaseResult=!1)=>{if((routeFlags&ROUTE_MAY_HAVE_BODY)!==0&&routeState?.parseBody!==!1)try{await parseRequestBody(req)}catch(err){const error=err instanceof Error?err:Error(String(err));return createMiddlewareErrorResponse(error,req)}const enhancedReq=req,csrfHandledByOuter=enhancedReq[CSRF_SEEDED_BY_HANDLE_REQUEST]===!0;if(!csrfHandledByOuter&&(routeFlags&ROUTE_RENDERS_CSRF)!==0&&requestMayRenderHtml(enhancedReq)){const renderTokenSeeding=seedCsrfTokenForRender(enhancedReq);if(renderTokenSeeding)await renderTokenSeeding}if(handlerKey&&(routeFlags&ROUTE_ACCEPTS_CSRF)!==0&&actionSkipsCsrfCache.get(handlerKey)===void 0){const pending=resolveStringHandler(handlerKey);if(pending instanceof Promise)try{await pending}catch{}}if((routeFlags&ROUTE_FORCES_JSON)!==0)req._forceJson=!0;if(!hasPreparedBaseResult&&synchronousInlineHandler&&(routeFlags&ROUTE_ACCEPTS_CSRF)===0&&!routeState?.middleware?.length&&!routeState?.rateLimit){try{preparedBaseResult=runWithRequestArguments(enhancedReq,invokeInlineHandler,enhancedReq,synchronousInlineHandler,void 0)}catch(error){preparedBaseResult=createHandlerErrorResponse(error,enhancedReq,routeKey,router)}hasPreparedBaseResult=!0;if(preparedBaseResult instanceof Response){const finished=finishSynchronousResult(enhancedReq,preparedBaseResult,csrfHandledByOuter,(routeFlags&ROUTE_SEEDS_CSRF)!==0);if(finished)return finished}}const rl=routeState?.rateLimit;if(rl)try{const{rateLimit:enforceRateLimit}=routeRateLimitModule??=await import("./rate-limit");await enforceRateLimit(routeKey,rl.max).over(rl.windowSeconds)}catch(err){return createMiddlewareErrorResponse(err,req)}const userMiddleware=routeState?.middleware??EMPTY_MIDDLEWARE_ENTRIES;let shouldInjectCsrf=!1;if((routeFlags&ROUTE_ACCEPTS_CSRF)!==0){const alreadyHasCsrf=userMiddleware.some((m)=>m==="csrf"||m.startsWith("csrf:")),routeCsrfMode=routeState?.csrfMode??CSRF_DEFAULT,routeSkipped=routeCsrfMode===CSRF_SKIPPED,routeRequired=routeCsrfMode===CSRF_REQUIRED,actionSkipped=(routeFlags&ROUTE_ACTION_SKIPS_CSRF)!==0||(handlerKey?actionSkipsCsrfCache.get(handlerKey)===!0:!1);shouldInjectCsrf=!alreadyHasCsrf&&(routeRequired||!routeSkipped&&!actionSkipped)}const middlewareEntries=shouldInjectCsrf?userMiddleware.length===0?CSRF_ONLY_MIDDLEWARE:["csrf",...userMiddleware]:userMiddleware;let middlewareTimings=EMPTY_MIDDLEWARE_TIMINGS;if(middlewareEntries.length>0){if(isDebugLogging()){const schemeEnd=req.url.indexOf("://"),pathStart=schemeEnd===-1?0:req.url.indexOf("/",schemeEnd+3),q=req.url.indexOf("?",pathStart<0?0:pathStart),urlPath=pathStart<0?"/":req.url.slice(pathStart,q===-1?void 0:q),routeMethod=routeKey.slice(0,routeKey.indexOf(":")).toUpperCase();log.debug(`[middleware] Executing chain: [${middlewareEntries.join(", ")}] for ${routeMethod} ${urlPath}`)}const cachedCsrfOnlyMiddleware=middlewareEntries===CSRF_ONLY_MIDDLEWARE?resolvedCsrfOnlyMiddleware:void 0,resolved=cachedCsrfOnlyMiddleware??[],resolvedCache=resolvedMiddlewareEntryCache??=new Map,unresolvedEntries=cachedCsrfOnlyMiddleware?EMPTY_MIDDLEWARE_ENTRIES:middlewareEntries;for(const middlewareEntry of unresolvedEntries){let resolvedEntry=resolvedCache.get(middlewareEntry);if(!resolvedEntry){const pending=parseMiddlewareEntry(middlewareEntry),parsed=pending instanceof Promise?await pending:pending,loaded=loadParsedMiddleware(parsed),middleware=loaded instanceof Promise?await loaded:loaded;if(middleware&&typeof middleware.handle==="function"){const rawPriority=middleware.priority;let priority=DEFAULT_MIDDLEWARE_PRIORITY;if(typeof rawPriority==="number"&&Number.isFinite(rawPriority)&&rawPriority>=0)priority=rawPriority;else if(rawPriority!==void 0)warnInvalidMiddlewarePriority(middlewareEntry,rawPriority);resolvedEntry={name:middlewareEntry,timingName:parsed.timingName,handler:middleware,priority,parameterName:parsed.params?parsed.name:void 0,params:parsed.params};resolvedCache.set(middlewareEntry,resolvedEntry)}}if(!resolvedEntry){log.error(`[Router] Middleware '${middlewareEntry}' on ${routeKey} could not be resolved - failing closed`);const failClosedError=Error(`Middleware '${middlewareEntry}' could not be resolved`),failClosedResponse=await createErrorResponse(failClosedError,enhancedReq,{status:500});return await applyCorsIfConfigured(enhancedReq,failClosedResponse)}if(resolvedEntry.params&&resolvedEntry.parameterName){enhancedReq._middlewareParams=enhancedReq._middlewareParams||{};enhancedReq._middlewareParams[resolvedEntry.parameterName]=resolvedEntry.params}resolved.push(resolvedEntry)}if(middlewareEntries===CSRF_ONLY_MIDDLEWARE&&!cachedCsrfOnlyMiddleware&&resolved.length===1&&resolvedCache===resolvedMiddlewareEntryCache)resolvedCsrfOnlyMiddleware=resolved;if(resolved.length>1)resolved.sort((a,b)=>a.priority-b.priority);const collectsMiddlewareTimings=enhancedReq._startNs!=null;if(collectsMiddlewareTimings)middlewareTimings=[];let chainTimer,chainBudget,runningMiddleware="";try{for(const{name:middlewareName,timingName,handler:middleware}of resolved){const mwStart=collectsMiddlewareTimings?performance.now():0;runningMiddleware=middlewareName;try{const outcome=middleware.handle(enhancedReq);if(outcome&&typeof outcome.then==="function"){if(!chainBudget){chainBudget=new Promise((_,reject)=>{chainTimer=setTimeout(()=>reject(Error(`Middleware '${runningMiddleware}' exceeded ${MIDDLEWARE_TIMEOUT_MS}ms`)),MIDDLEWARE_TIMEOUT_MS)});chainBudget.catch(()=>{})}await Promise.race([outcome,chainBudget])}if(collectsMiddlewareTimings){const elapsedMs=performance.now()-mwStart;middlewareTimings.push({name:timingName,ms:elapsedMs})}}catch(error){if(collectsMiddlewareTimings){const elapsedMs=performance.now()-mwStart;middlewareTimings.push({name:timingName,ms:elapsedMs})}log.debug(`[middleware] Blocked by: ${middlewareName}`);if(error instanceof Response){try{applyRequestedResponseHeaders(enhancedReq,error.headers);const{_requestId:reqId,_startNs:startNs}=enhancedReq,total=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null,parts=total!=null?[`total;dur=${total.toFixed(1)}`]:[];for(const t of middlewareTimings)parts.push(`mw_${t.name};dur=${t.ms.toFixed(1)}`);if(parts.length>0)error.headers.set("Server-Timing",parts.join(", "));if(reqId)error.headers.set("X-Request-ID",reqId)}catch{}runAfterResponse(enhancedReq,error.status,elapsedSinceStart(enhancedReq)??0);return await applyCorsIfConfigured(enhancedReq,error)}const err=error instanceof Error?error:Error(String(error)),errorResponse="statusCode"in err||"status"in err?await createMiddlewareErrorResponse(err,enhancedReq):await(()=>{log.error(`[Router] Middleware '${middlewareName}' threw an unexpected error:`,err);return createErrorResponse(err,enhancedReq,{status:500})})();try{applyRequestedResponseHeaders(enhancedReq,errorResponse.headers);const{_requestId:reqId,_startNs:startNs}=enhancedReq,total=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null,parts=total!=null?[`total;dur=${total.toFixed(1)}`]:[];for(const t of middlewareTimings)parts.push(`mw_${t.name};dur=${t.ms.toFixed(1)}`);if(parts.length>0)errorResponse.headers.set("Server-Timing",parts.join(", "));if(reqId)errorResponse.headers.set("X-Request-ID",reqId)}catch{}runAfterResponse(enhancedReq,errorResponse.status,elapsedSinceStart(enhancedReq)??0);return await applyCorsIfConfigured(enhancedReq,errorResponse)}}}finally{if(chainTimer)clearTimeout(chainTimer)}}const formatsResolvedInlineResult=asynchronousInlineHandler!==void 0&&!hasPreparedBaseResult;let response;try{const baseResult=hasPreparedBaseResult?preparedBaseResult:asynchronousInlineHandler?asynchronousInlineHandler(enhancedReq):synchronousInlineHandler?invokeInlineHandler(enhancedReq,synchronousInlineHandler,void 0):wrappedBase(enhancedReq),resolvedResult=baseResult instanceof Response?baseResult:await baseResult;response=formatsResolvedInlineResult?formatResult(resolvedResult,enhancedReq):resolvedResult}catch(error){response=await createHandlerErrorResponse(error,enhancedReq,handlerKey||routeKey,router)}if(response){if((routeFlags&ROUTE_SEEDS_CSRF)!==0&&!csrfHandledByOuter&&enhancedReq[CSRF_SEEDED_BY_HANDLE_REQUEST]!==!0)try{const mod=loadCsrfModule(),csrf=mod instanceof Promise?await mod:mod;if(csrf)response=csrf.seedCsrfCookieIfMissing(enhancedReq,response,enhancedReq._csrfToken,typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number")}catch(err){log.warn("[router] CSRF cookie seeding failed",{error:err})}}if(response&&enhancedReq._corsConfig){const corsResponse=applyCorsIfConfigured(enhancedReq,response);response=corsResponse instanceof Response?corsResponse:await corsResponse}const{_requestId:reqId,_startNs:startNs}=enhancedReq,durMs=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null,{_afterResponse:after,_responseHeaders:requested}=enhancedReq,frameworkMetadataApplied=response&&typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number";if(response&&(response.status>=400||Array.isArray(after)||requested&&typeof requested==="object"||durMs!=null||!frameworkMetadataApplied)&&typeof response.headers?.set==="function"){const setHeaders=(h)=>{runAfterResponse(enhancedReq,response.status,durMs??0);applyRequestedResponseHeaders(enhancedReq,h);if(reqId&&!frameworkMetadataApplied)h.set("X-Request-ID",reqId);if(durMs!=null){let timing=`total;dur=${durMs.toFixed(1)}`;for(const t of middlewareTimings)timing+=`, mw_${t.name};dur=${t.ms.toFixed(1)}`;h.set("Server-Timing",timing)}if(!frameworkMetadataApplied)applySecurityHeaders(h)};if(response.status>=400&&(response.headers.get("content-type")||"").includes("json")&&reqId)try{const text=await response.clone().text(),parsed=JSON.parse(text);if(parsed&&typeof parsed==="object"&&!Array.isArray(parsed)&&parsed.jsonrpc!=="2.0"){const newHeaders=new Headers(response.headers);setHeaders(newHeaders);return new Response(JSON.stringify({...parsed,request_id:reqId}),{status:response.status,statusText:response.statusText,headers:newHeaders})}}catch{}try{setHeaders(response.headers)}catch{try{const cloned=response.clone(),newHeaders=new Headers(response.headers);setHeaders(newHeaders);return new Response(cloned.body,{status:response.status,statusText:response.statusText,headers:newHeaders})}catch{}}}if(enhancedReq._compress===!0&&response)try{const cache=compressionApplierCache,applyCompression=cache.apply??=(await import(resolveDefaultsPath("app/Middleware/Compress.ts"))).applyCompression,bodySizeUpperBound=response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND];return await applyCompression(enhancedReq,response,typeof bodySizeUpperBound==="number"?bodySizeUpperBound:void 0)}catch(err){log.warn(`[router] Compression failed; sending uncompressed response: ${err instanceof Error?err.message:String(err)}`)}return response};if(!synchronousInlineHandler||(routeFlags&ROUTE_MAY_HAVE_BODY)!==0)return rememberStacksRouteHandler(bindAsyncRouteHandler(handleAsyncInContext));return rememberStacksRouteHandler((req)=>{if(routeState?.middleware?.length||routeState?.rateLimit)return runWithRequestArgument(req,handleAsyncInContext,req);const csrfHandledByOuter=req[CSRF_SEEDED_BY_HANDLE_REQUEST]===!0;if((routeFlags&ROUTE_RENDERS_CSRF)!==0&&!csrfHandledByOuter&&requestMayRenderHtml(req)){const renderTokenSeeding=seedCsrfTokenForRender(req);if(renderTokenSeeding)return renderTokenSeeding.then(()=>runWithRequestArgument(req,handleAsyncInContext,req))}if((routeFlags&ROUTE_FORCES_JSON)!==0)req._forceJson=!0;let preparedBaseResult;try{preparedBaseResult=runWithRequestArguments(req,invokeInlineHandler,req,synchronousInlineHandler,void 0)}catch(error){preparedBaseResult=createHandlerErrorResponse(error,req,routeKey,router)}if(preparedBaseResult instanceof Response){const finished=finishSynchronousResult(req,preparedBaseResult,csrfHandledByOuter,(routeFlags&ROUTE_SEEDS_CSRF)!==0);if(finished)return finished}return runWithRequestArguments(req,handleAsyncInContext,req,preparedBaseResult,!0)})}function createInertRoute(){const inert={parseBody:()=>inert,middleware:()=>inert,name:()=>inert,skipCsrf:()=>inert,requireCsrf:()=>inert,rateLimit:()=>inert};return inert}function createChainableRoute(routeStates,routeKey,shadowed=!1,siblingRouteKeys=[]){if(shadowed)return createInertRoute();const routePath=routeKey.includes(":")?routeKey.substring(routeKey.indexOf(":")+1):routeKey,states=[routeKey,...siblingRouteKeys].flatMap((key)=>{const state=routeStates.get(key);return state?[state]:[]}),chain={parseBody(enabled){if(typeof enabled!=="boolean")throw TypeError("parseBody() requires a boolean");for(const state of states)state.parseBody=enabled;return chain},middleware(name){for(const entry of Array.isArray(name)?name:[name]){if(typeof entry!=="string")throw TypeError(`[Router] middleware() on ${routeKey} was given a ${typeof entry}; it takes an alias or an array of aliases`);for(const state of states)(state.middleware??=[]).push(entry)}return chain},name(routeName){(namedRouteRegistry??=new Map).set(routeName,compileNamedRoute(routePath));return chain},skipCsrf(){for(const state of states)state.csrfMode=CSRF_SKIPPED;return chain},requireCsrf(){for(const state of states)state.csrfMode=CSRF_REQUIRED;return chain},rateLimit(max,window){if(!Number.isFinite(max)||max<=0)throw Error(`[Router] .rateLimit(): max must be a positive number, got ${String(max)}`);const windowSeconds=rateLimitWindowToSeconds(window);for(const state of states)state.rateLimit={max:Math.floor(max),windowSeconds};return chain}};return chain}async function fileExists(path){try{return await Bun.file(path).exists()}catch{return!1}}function assertSafeHandlerPath(handlerPath){if(typeof handlerPath!=="string"||handlerPath.length===0)throw Error(`[Router] Refusing to resolve handler '${String(handlerPath)}': empty or non-string`);if(handlerPath.includes("\x00"))throw Error("[Router] Refusing to resolve handler with null byte");if(handlerPath.startsWith("/")||/^[A-Za-z]:[\\/]/.test(handlerPath))throw Error(`[Router] Refusing to resolve absolute handler path '${handlerPath}'`);if(handlerPath.split(/[/\\]/).some((s)=>s===".."))throw Error(`[Router] Refusing to resolve handler path '${handlerPath}' (contains '..' segment)`)}let _moduleImportCache;function cachedImport(fullPath){const cache=_moduleImportCache??=new Map;let p=cache.get(fullPath);if(!p){p=import(fullPath);cache.set(fullPath,p)}return p}let _resolvedHandlerCache;function resolveStringHandler(handlerPath){const cache=_resolvedHandlerCache??=new Map;let resolved=cache.get(handlerPath);if(!resolved){resolved=resolveStringHandlerUncached(handlerPath).then((handler)=>{cache.set(handlerPath,handler);return handler},(error)=>{cache.delete(handlerPath);throw error});cache.set(handlerPath,resolved)}return resolved}function validationFailureResponse(errors){return response.validationError(errors)}export function precognitionRequest(req,knownHeader){const header=knownHeader===void 0?req.headers?.get?.("Precognition"):knownHeader,viaHeader=typeof header==="string"&&header.toLowerCase()==="true";let viaQuery=!1;try{if(!viaHeader&&req.url.includes("?"))viaQuery=new URL(req.url).searchParams.get("_validate")==="1"}catch{viaQuery=!1}if(!viaHeader&&!viaQuery)return null;return{only:(req.headers?.get?.("Precognition-Validate-Only")??"").split(",").map((field)=>field.trim()).filter(Boolean)}}export function precognitionSuccess(){return new Response(null,{status:204,headers:{Precognition:"true","Precognition-Success":"true",Vary:"Precognition, Precognition-Validate-Only"}})}let actionRegistryPromise=null;async function getActionRegistry(){if(actionRegistryPromise)return actionRegistryPromise;actionRegistryPromise=(async()=>{const registryPath=`${storagePath("framework/auto-imports")}/actions.ts`;if(!existsSync(registryPath))return null;const module=await import(registryPath);if(!module.actions)throw Error(`Invalid actions registry: ${registryPath}`);return module.actions})();return actionRegistryPromise}function isInsideAppActions(file){const local=relative(appPath("Actions"),file);return Boolean(local)&&local!==".."&&!local.startsWith(`..${sep}`)&&!isAbsolute(local)}const staleRegistryWarned=new Set;function warnStaleActionRegistry(name,registered,appFile){if(staleRegistryWarned.has(name))return;staleRegistryWarned.add(name);log.warn(`[router] The action registry maps ${name} to ${registered}, but the app has ${appFile}; using the app's. The registry is stale: run \`./buddy generate:auto-imports\` and commit storage/framework/auto-imports if you track it.`)}function appActionModulePath(sourcePath){if(!sourcePath.endsWith(".ts")||lstatSync(sourcePath,{throwIfNoEntry:!1}))return sourcePath;const local=relative(appPath("Actions"),sourcePath);if(!local||local===".."||local.startsWith(`..${sep}`)||isAbsolute(local))return sourcePath;const emitted=`${sourcePath.slice(0,-3)}.js`;return statSync(emitted,{throwIfNoEntry:!1})?.isFile()?emitted:sourcePath}const providedActions=new Map;export function provideActions(loaders){for(const[name,load]of Object.entries(loaders))providedActions.set(name.endsWith(".ts")?name.slice(0,-3):name,load)}async function resolveStringHandlerUncached(handlerPath){assertSafeHandlerPath(handlerPath);let modulePath=handlerPath;modulePath=modulePath.endsWith(".ts")?modulePath.slice(0,-3):modulePath;const provided=providedActions.get(modulePath);if(provided){const action=(await provided()).default;if(!action||typeof action.handle!=="function")throw Error(`Action '${handlerPath}' has no default export with a handle() method`);return wrapAction(action,handlerPath)}if(modulePath.includes("Controller")){const[controllerPath,methodName="index"]=modulePath.split("@"),userPath=appPath(`${controllerPath}.ts`),defaultPath=resolveDefaultsPath(`app/${controllerPath}.ts`),fullPath=await fileExists(userPath)?userPath:defaultPath;try{const controller=await cachedImport(fullPath);if(!controller.default||typeof controller.default!=="function")throw Error(`Controller ${controllerPath} does not export a default class`);const instance=new controller.default;if(typeof instance[methodName]!=="function")throw Error(`Method ${methodName} not found in controller ${controllerPath}`);return async(req)=>{const result=await instance[methodName](req);return formatResult(result,req)}}catch(error){log.error(`[Router] Failed to load controller '${fullPath}':`,error);throw error}}let fullPath;if(modulePath.includes("storage/framework/orm"))fullPath=modulePath;else if(modulePath.includes("OrmAction"))fullPath=storagePath(`framework/actions/src/${modulePath}.ts`);else if(modulePath.includes("Actions")){const specifier=(await getActionRegistry())?.[modulePath],registered=specifier?resolveModulePath(specifier,storagePath("framework/auto-imports")):void 0,userPath=appActionModulePath(projectPath(`app/${modulePath}.ts`));if(registered&&!isInsideAppActions(registered)&&await fileExists(userPath)){warnStaleActionRegistry(modulePath,registered,userPath);fullPath=userPath}else if(registered)fullPath=appActionModulePath(registered);else{const defaultPath=resolveDefaultsPath(`app/${modulePath}.ts`);fullPath=await fileExists(userPath)?userPath:defaultPath}}else{const userPath=appPath(`${modulePath}.ts`),defaultPath=resolveDefaultsPath(`app/${modulePath}.ts`);fullPath=await fileExists(userPath)?userPath:defaultPath}try{const action=(await cachedImport(fullPath)).default;if(!action)throw Error(`Action '${handlerPath}' has no default export`);if(typeof action.handle!=="function"){log.error(`[Router] Action '${handlerPath}' structure:`,Object.keys(action));throw Error(`Action '${handlerPath}' has no handle() method. Got: ${typeof action.handle}`)}return wrapAction(action,handlerPath)}catch(importError){log.error(`[Router] Failed to import action '${fullPath}':`,importError);throw importError}}export function isRouterAction(handler){return typeof handler==="object"&&handler!==null&&typeof handler.handle==="function"}export function wrapAction(action,handlerKey){const actionSkipsCsrf=action.skipCsrf===!0||action.csrf===!1;actionSkipsCsrfCache.set(handlerKey,actionSkipsCsrf);const actionForcesJson=action.apiResponse===!0,requestValidationRules=action.validations??modelValidationRules(action.modelDefinition??action.model),actionValidationEntries=action.validations?compileActionValidationEntries(action.validations):void 0,routeSeparator=handlerKey.indexOf(":"),actionMayHaveRouteParams=routeSeparator===-1||handlerKey.indexOf("{",routeSeparator+1)!==-1,prepareRequest=(req)=>{const precognitionHeader=req.headers.get("Precognition"),requestHasQuery=req.url.includes("?"),precognition=precognitionHeader===null&&!requestHasQuery?null:precognitionRequest(req,precognitionHeader);if(precognition){if(!action.validations)return precognitionSuccess();const rules=precognition.only.length>0?Object.fromEntries(Object.entries(action.validations).filter(([field])=>precognition.only.includes(field))):action.validations,precognitionResult=validateActionInputSync(req,rules,rules===action.validations?actionValidationEntries:void 0,actionMayHaveRouteParams,!0,requestHasQuery);return precognitionResult.valid?precognitionSuccess():validationFailureResponse(precognitionResult.errors)}if(action.validations){const validationResult=validateActionInputSync(req,action.validations,actionValidationEntries,actionMayHaveRouteParams,!0,requestHasQuery);if(!validationResult.valid)return validationFailureResponse(validationResult.errors)}},rethrowActionError=(handleError)=>{report(handleError,{label:`[Router] action.handle() for '${handlerKey}'`});throw handleError};if(typeof action.authorize!=="function"&&typeof action.before!=="function")return(req)=>{if(actionSkipsCsrf)req._skipCsrf=!0;if(actionForcesJson)req._forceJson=!0;req._requestValidationRules=requestValidationRules;try{const earlyResponse=prepareRequest(req);if(earlyResponse)return earlyResponse;const result=action.handle(req);return result instanceof Promise?result.then((value)=>{try{return formatResult(value,req)}catch(error){return rethrowActionError(error)}},rethrowActionError):formatResult(result,req)}catch(handleError){return rethrowActionError(handleError)}};return async(req)=>{if(actionSkipsCsrf)req._skipCsrf=!0;if(actionForcesJson)req._forceJson=!0;req._requestValidationRules=requestValidationRules;try{const earlyResponse=prepareRequest(req);if(earlyResponse)return earlyResponse;if(typeof action.authorize==="function"){const pendingAuth=action.authorize(req),auth=pendingAuth!==null&&(typeof pendingAuth==="object"||typeof pendingAuth==="function")?await pendingAuth:pendingAuth;if(auth instanceof Response)return auth;if(auth===!1)return Response.json({error:"Forbidden"},{status:403})}if(typeof action.before==="function"){const pendingBefore=action.before(req),pre=pendingBefore!==null&&(typeof pendingBefore==="object"||typeof pendingBefore==="function")?await pendingBefore:pendingBefore;if(pre instanceof Response)return pre}const pendingResult=action.handle(req),result=pendingResult instanceof Promise?await pendingResult:pendingResult;return formatResult(result,req)}catch(handleError){return rethrowActionError(handleError)}}}const EMPTY_VALIDATION_ERRORS=Object.freeze({}),VALID_ACTION_VALIDATION_RESULT=Object.freeze({valid:!0,errors:EMPTY_VALIDATION_ERRORS});function compileActionValidationEntries(validations){return Object.entries(validations).map(([field,validation])=>[field,validation,void 0])}function createValidationFieldLabel(field){const label=field.replace(/[-_]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").replace(/^./,(c)=>c.toUpperCase()),lowerField=field.toLowerCase();return{label,decorate:(message)=>{if(message.toLowerCase().startsWith(lowerField)||message.includes(label))return message;if(message.startsWith("This field "))return`${label} ${message.slice(11)}`;return`${label} ${/^[A-Z][a-z]/.test(message)?message[0].toLowerCase()+message.slice(1):message}`}}}function validateActionInputSync(req,validations,compiledEntries,mayHaveRouteParams=!0,reuseSuccessResult=!1,requestHasQuery=req.url.includes("?")){let errors;const validated=newInput();let valid=!0;const entries=compiledEntries??Object.entries(validations),input=getRequestInput(req,entries,mayHaveRouteParams,requestHasQuery);for(let entryIndex=0;entryIndex<entries.length;entryIndex++){const entry=entries[entryIndex],field=entry[0],validation=entry[1],value=input[field];let rule=validation.rule,result;try{if(rule.__conditionals?.length)rule=require("@stacksjs/validation/conditional").applyConditionals(rule,input);result=validation.message&&typeof validation.message==="object"?validationMessages().validateRule(rule,value):rule.validate(value)}catch{result={valid:!1,errors:[{message:`${field} validation failed`}]}}if(result&&!result.valid){valid=!1;const fieldErrors=[],{label,decorate}=entry[2]??=createValidationFieldLabel(field),reported=Array.isArray(result.errors)?result.errors:Object.values(result.errors??{}).flat();if(reported.length>0)if(validation.message&&typeof validation.message==="object")fieldErrors.push(...validationMessages().fieldErrorMessages(rule,value,reported,validation.message,field,decorate));else if(validation.message)fieldErrors.push(validation.message);else reported.forEach((err)=>fieldErrors.push(decorate(err.message)));else fieldErrors.push(validation.message?typeof validation.message==="string"?validation.message:`${label} is invalid`:`${label} is invalid`);(errors??=Object.create(null))[field]=fieldErrors}else if(value!==void 0)validated[field]=result&&Object.hasOwn(result,"value")?result.value:value}if(valid)req._validatedInput=validated;if(valid&&reuseSuccessResult)return VALID_ACTION_VALIDATION_RESULT;return{valid,errors:errors??{}}}export async function validateActionInput(req,validations){return validateActionInputSync(req,validations)}function modelValidationRules(model){if(!model?.attributes||typeof model.attributes!=="object")return;const rules={};for(const[field,attribute]of Object.entries(model.attributes)){const validation=attribute?.validation;if(validation?.rule)rules[field]=validation}return Object.keys(rules).length>0?rules:void 0}function newInput(){return Object.create(null)}function assignInput(target,source){for(const key of Object.keys(source))target[key]=source[key];return target}function getRequestInput(req,validationEntries,mayHaveRouteParams=!0,requestHasQuery=req.url.includes("?")){let input,mayNeedCoercion=!1;if(requestHasQuery){const q=req.query;if(q)for(const key in q){(input??=newInput())[key]=q[key];mayNeedCoercion=!0}else new URL(req.url).searchParams.forEach((value,key)=>{(input??=newInput())[key]=value;mayNeedCoercion=!0})}if(req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody))input=assignInput(input??newInput(),req.jsonBody);else if(req.formBody&&typeof req.formBody==="object"){input=assignInput(input??newInput(),req.formBody);mayNeedCoercion=!0}let hasRouteParams=!1;if(mayHaveRouteParams&&req.params)for(const key in req.params){if(!Object.hasOwn(req.params,key))continue;(input??=newInput())[key]=req.params[key];hasRouteParams=!0;mayNeedCoercion=!0}if(!requestHasQuery&&!mayHaveRouteParams&&req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody)&&!req.formBody&&!req.files)req._allInputCache=input;if(req.files&&typeof req.allFiles==="function")try{const files=req.allFiles();for(const key of Object.keys(files??{})){const values=input??=newInput();if(!(key in values))values[key]=files[key]}}catch{}if(!validationEntries)return input??{};input??={};let coerced=!1;if(mayNeedCoercion)for(const[field,validation]of validationEntries){const value=input[field];if(typeof value!=="string")continue;const validatorName=validation.rule?.name;if(validatorName==="number"){const n=Number(value);if(Number.isFinite(n)){input[field]=n;coerced=!0}}else if(validatorName==="boolean"){if(value==="true"||value==="1"){input[field]=!0;coerced=!0}else if(value==="false"||value==="0"){input[field]=!1;coerced=!0}}}if(!coerced&&!req.formBody&&!req.files&&!hasRouteParams)req._allInputCache=input;return input}function formatResult(result,req){if(result instanceof Response)return result;if(result instanceof ReadableStream)return new Response(result,{headers:{"Content-Type":"application/octet-stream"}});if(result!==null&&typeof result==="object"){const linkHeader="data"in result?buildPaginatorLinkHeader(result):null;return formatJsonResult(result,req,linkHeader)}const apiShaped=req._forceJson===!0||isApiRequest(req);if(result===null||result===void 0)return apiShaped?new Response(null,{status:204}):new Response("",{status:200});if(apiShaped){if(typeof result==="string"||typeof result==="number"||typeof result==="boolean")return formatJsonResult(result,req);return serializedResponse(JSON.stringify(result)??"","application/json;charset=utf-8")}return serializedResponse(String(result),"text/plain; charset=utf-8")}function serializedResponse(body,contentType){return new Response(body,{headers:{"Content-Type":contentType,"Content-Length":String(Buffer.byteLength(body))}})}function formatJsonResult(result,req,linkHeader){const canPreapplyMetadata=!req._responseHeaders,body=JSON.stringify(result)??"",requestMarkers=req,directNativeRequest=typeof requestMarkers[CSRF_SECURE_TRANSPORT]==="boolean"||requestMarkers[NATIVE_DIRECT_ROUTE_REQUEST]===!0,bodyLength=canPreapplyMetadata&&directNativeRequest?void 0:Buffer.byteLength(body),csrf=requestMarkers[CSRF_SEEDED_BY_HANDLE_REQUEST]!==!0&&typeof requestMarkers[CSRF_SECURE_TRANSPORT]==="boolean"?loadCsrfModule():null,csrfCookie=canPreapplyMetadata&&csrf&&!(csrf instanceof Promise)&&typeof csrf.createCsrfCookie==="function"?csrf.createCsrfCookie(req,req._csrfToken):void 0,response=canPreapplyMetadata?secureSerializedJsonResponse(body,bodyLength,req._requestId,csrfCookie):new Response(body,{headers:createJsonSecurityHeaders()});if(!canPreapplyMetadata)response.headers.set("Content-Length",String(bodyLength));if(linkHeader)response.headers.set("Link",linkHeader);if(canPreapplyMetadata){const frameworkResponse=response;frameworkResponse[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]=bodyLength??(body.length*3>=1024&&body.length<1024?Buffer.byteLength(body):body.length*3)}if(csrfCookie)requestMarkers[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;return response}function buildPaginatorLinkHeader(value){if(!isPaginator(value)&&!isSimplePaginator(value)&&!isCursorPaginator(value))return null;const v=value,parts=[];if(v.prev_page_url)parts.push(`<${v.prev_page_url}>; rel="prev"`);if(v.next_page_url)parts.push(`<${v.next_page_url}>; rel="next"`);if(v.first_page_url)parts.push(`<${v.first_page_url}>; rel="first"`);if(v.last_page_url)parts.push(`<${v.last_page_url}>; rel="last"`);return parts.length>0?parts.join(", "):null}function iterableToStream(source){const encoder=new TextEncoder;let iterator;return new ReadableStream({async pull(controller){iterator??=source[Symbol.asyncIterator]();try{const{value,done}=await iterator.next();if(done)controller.close();else controller.enqueue(typeof value==="string"?encoder.encode(value):value)}catch(err){controller.error(err)}},async cancel(reason){await iterator?.return?.(reason)}},{highWaterMark:1})}export function stream(source,options={}){const baseHeaders={};if(options.type==="sse"){baseHeaders["Content-Type"]="text/event-stream; charset=utf-8";baseHeaders["Cache-Control"]="no-cache";baseHeaders.Connection="keep-alive"}else if(options.type==="ndjson")baseHeaders["Content-Type"]="application/x-ndjson; charset=utf-8";else baseHeaders["Content-Type"]=options.contentType??"application/octet-stream";const body=source instanceof ReadableStream?source:iterableToStream(source),merged=new Headers(baseHeaders);if(options.headers)new Headers(options.headers).forEach((value,key)=>merged.set(key,value));return new Response(body,{status:options.status??200,headers:merged})}function getAllInputFor(req){const cached=req._allInputCache;if(cached)return cached;const input=newInput(),query=req.query;if(query)for(const key in query)input[key]=query[key];if(req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody))assignInput(input,req.jsonBody);if(req.formBody&&typeof req.formBody==="object")assignInput(input,req.formBody);if(req.params&&typeof req.params==="object")assignInput(input,req.params);req._allInputCache=input;return input}function flashInputFor(req,keys){const input=getAllInputFor(req);req._oldInput=keys?Object.fromEntries(keys.filter((key)=>(key in input)).map((key)=>[key,input[key]])):{...input}}const nativeRequestText=Request.prototype.text,nativeRequestJson=Request.prototype.json,nativeRequestBytes=Request.prototype.bytes,nativeRequestArrayBuffer=Request.prototype.arrayBuffer,nativeRequestBlob=Request.prototype.blob,nativeRequestClone=Request.prototype.clone;let requestBodyEncoder,requestValidationModule,validationMessagesModule;function validationMessages(){return validationMessagesModule??=require("@stacksjs/validation/messages")}let UploadedFileConstructor,requestGateModule;function createUploadedFile(file){UploadedFileConstructor??=require("@stacksjs/storage/uploaded-file").UploadedFile;return new UploadedFileConstructor(file)}const REQUEST_METHODS={text(){return this._rawBody===void 0?nativeRequestText.call(this):Promise.resolve(this._rawBody)},json(){if(this._rawBody===void 0)return nativeRequestJson.call(this);try{return Promise.resolve(this._rawBody.length===0?null:JSON.parse(this._rawBody))}catch(error){return Promise.reject(error)}},bytes(){return this._rawBody===void 0?nativeRequestBytes.call(this):Promise.resolve((requestBodyEncoder??=new TextEncoder).encode(this._rawBody))},arrayBuffer(){if(this._rawBody===void 0)return nativeRequestArrayBuffer.call(this);const bytes=(requestBodyEncoder??=new TextEncoder).encode(this._rawBody);return Promise.resolve(bytes.buffer)},blob(){return this._rawBody===void 0?nativeRequestBlob.call(this):Promise.resolve(new Blob([this._rawBody],{type:this._rawBodyContentType}))},clone(){if(this._rawBody===void 0)return nativeRequestClone.call(this);return new Request(this.url,{method:this.method,headers:this.headers,body:this._rawBody})},get(key,defaultValue){const value=getAllInputFor(this)[key];return value!==void 0?value:defaultValue},input(key,defaultValue){const value=getAllInputFor(this)[key];return value!==void 0?value:defaultValue},all(){return getAllInputFor(this)},only(keys){const input=getAllInputFor(this),result={};for(const key of keys)if(key in input)result[key]=input[key];return result},except(keys){const result={...getAllInputFor(this)};for(const key of keys)delete result[key];return result},has(key){const input=getAllInputFor(this);if(Array.isArray(key))return key.every((k)=>(k in input)&&input[k]!==void 0);return key in input&&input[key]!==void 0},hasAny(keys){const input=getAllInputFor(this);return keys.some((k)=>(k in input)&&input[k]!==void 0)},filled(key){const input=getAllInputFor(this),isFilled=(k)=>{const value=input[k];return value!==void 0&&value!==null&&value!==""&&!(Array.isArray(value)&&value.length===0)};if(Array.isArray(key))return key.every(isFilled);return isFilled(key)},missing(key){const input=getAllInputFor(this);if(Array.isArray(key))return key.every((k)=>!(k in input)||input[k]===void 0);return!(key in input)||input[key]===void 0},merge(data){Object.assign(getAllInputFor(this),data)},keys(){return Object.keys(getAllInputFor(this))},string(key,defaultValue=""){const value=getAllInputFor(this)[key];return value!==void 0&&value!==null?String(value):defaultValue},integer(key,defaultValue=0){const value=getAllInputFor(this)[key];if(value===void 0||value===null||value==="")return defaultValue;if(typeof value==="number")return Number.isFinite(value)?Math.trunc(value):defaultValue;const str=String(value).trim();if(!/^-?\d+$/.test(str))return defaultValue;const parsed=Number.parseInt(str,10);return Number.isFinite(parsed)?parsed:defaultValue},float(key,defaultValue=0){const value=getAllInputFor(this)[key];if(value===void 0||value===null||value==="")return defaultValue;if(typeof value==="number")return Number.isFinite(value)?value:defaultValue;const str=String(value).trim();if(!/^-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(str))return defaultValue;const parsed=Number.parseFloat(str);return Number.isFinite(parsed)?parsed:defaultValue},boolean(key,defaultValue=!1){const value=getAllInputFor(this)[key];if(value===void 0||value===null)return defaultValue;if(typeof value==="boolean")return value;if(value==="true"||value==="1"||value===1)return!0;if(value==="false"||value==="0"||value===0)return!1;return defaultValue},array(key){const value=getAllInputFor(this)[key];if(Array.isArray(value))return value;return value!==void 0&&value!==null?[value]:[]},date(key){const value=getAllInputFor(this)[key];if(value===void 0||value===null||value==="")return null;const parsed=new Date(value);return Number.isNaN(parsed.getTime())?null:parsed},enum(key,enumType){const value=getAllInputFor(this)[key];if(value===void 0||value===null)return null;if(Object.values(enumType).includes(value))return value;const enumKey=String(value);return enumKey in enumType?enumType[enumKey]:null},collect(key){const{collect}=require("@stacksjs/collections"),value=getAllInputFor(this)[key];if(Array.isArray(value))return collect(value);return collect(value===void 0||value===null?[]:[value])},whenHas(key,callback,defaultCallback){const input=getAllInputFor(this);if(key in input&&input[key]!==void 0)callback(input[key]);else defaultCallback?.()},whenFilled(key,callback,defaultCallback){const value=getAllInputFor(this)[key];if(value!==void 0&&value!==null&&value!==""&&!(Array.isArray(value)&&value.length===0))callback(value);else defaultCallback?.()},isValue(key,value){return getAllInputFor(this)[key]===value},async validate(rules,messages={}){const selectedRules=rules??this._requestValidationRules;if(!selectedRules||Object.keys(selectedRules).length===0){const input=getAllInputFor(this);this._validatedInput=input;return input}const entries=Object.entries(selectedRules);let normalized=selectedRules;for(let index=0;index<entries.length;index++){const[field,definition]=entries[index];if(typeof definition==="string")throw TypeError(`String validation rules are not supported for "${field}". Use schema validators.`);if(definition&&typeof definition==="object"&&"rule"in definition){const message=messages[field];if(message){if(normalized===selectedRules){normalized={};for(let previousIndex=0;previousIndex<index;previousIndex++){const[previousField,previousDefinition]=entries[previousIndex];normalized[previousField]=previousDefinition}}normalized[field]={...definition,message};continue}}if(normalized!==selectedRules)normalized[field]=definition}const{validate}=requestValidationModule??=await import("@stacksjs/validation/request-validator"),validated=await validate(this,normalized);this._validatedInput=validated;return validated},getValidated(){return this._validatedInput??{}},safe(){const data=this._validatedInput??{};return{all:()=>({...data}),get:(key,defaultValue)=>(key in data)?data[key]:defaultValue,only:(keys)=>Object.fromEntries(keys.filter((key)=>(key in data)).map((key)=>[key,data[key]])),except:(keys)=>Object.fromEntries(Object.entries(data).filter(([key])=>!keys.includes(key)))}},old(key,defaultValue){return this._oldInput?.[key]??defaultValue},flashInput(keys){flashInputFor(this,keys)},flashInputOnly(keys){flashInputFor(this,keys)},flashInputExcept(keys){const input=getAllInputFor(this);this._oldInput=Object.fromEntries(Object.entries(input).filter(([key])=>!keys.includes(key)))},file(key){const file=(this.files||{})[key];if(!file)return null;const rawFile=Array.isArray(file)?file[0]:file;return rawFile?createUploadedFile(rawFile):null},getFiles(key){const file=(this.files||{})[key];if(!file)return[];return(Array.isArray(file)?file:[file]).map(createUploadedFile)},hasFile(key){const files=this.files||{};return key in files&&files[key]!==void 0},allFiles(){const files=this.files||{},result={};for(const[key,value]of Object.entries(files))if(Array.isArray(value))result[key]=value.map((f)=>createUploadedFile(f));else result[key]=createUploadedFile(value);return result},getParams(){return{...this.params}},isEmpty(){return Object.keys(getAllInputFor(this)).length===0},browser(){return this.headers.get("sec-ch-ua")||this.headers.get("user-agent")},ipForRateLimit(){const ip=this.ip;if(typeof ip==="function")return ip.call(this)||null;return typeof ip==="string"&&ip?ip:null},getMethod(){return this.method.toUpperCase()},async user(){return this._authenticatedUser},async userToken(){return this._currentAccessToken},async tokenCan(ability){if(typeof ability!=="string"||ability.length===0)return!1;const token=this._currentAccessToken;if(!token||typeof token!=="object")return!1;const abilities=token.abilities;if(!Array.isArray(abilities))return!1;if(abilities.includes("*"))return!0;return abilities.includes(ability)},async tokenCant(ability){return!await this.tokenCan(ability)},async can(ability,...args){if(typeof ability!=="string"||ability.length===0)return!1;const{Gate}=requestGateModule??=await import("@stacksjs/auth/gate"),user=this._authenticatedUser??null;return Gate.allows(ability,user,...args)},async cannot(ability,...args){return!await this.can(ability,...args)},async authorize(ability,...args){const{Gate}=requestGateModule??=await import("@stacksjs/auth/gate"),user=this._authenticatedUser??null;await Gate.authorize(ability,user,...args)}},stacksRequestPrototypes=new WeakMap,STACKS_REQUEST_ENHANCED=Symbol.for("stacks.router.requestEnhanced");function fuseRequestEnhancements(router,initializeRequestIds=!0){const original=router.enhanceRequest.bind(router),combinedPrototypes=new WeakMap;router.enhanceRequest=(request,params={})=>{const basePrototype=Object.getPrototypeOf(request),combined=combinedPrototypes.get(basePrototype);if(combined){const enhanced=request;if(enhanced.params!==params)if("params"in request)Object.defineProperty(enhanced,"params",{value:params,writable:!0,configurable:!0,enumerable:!1});else enhanced.params=params;Object.setPrototypeOf(enhanced,combined);if(initializeRequestIds&&!enhanced._requestId)enhanced._requestId=incomingRequestId(enhanced)??generateRequestId();return enhanced}const enhanced=enhanceRequest(original(request,params),initializeRequestIds);combinedPrototypes.set(basePrototype,Object.getPrototypeOf(enhanced));return enhanced}}let csrfModule,csrfModuleLoad;function loadCsrfModule(){if(csrfModule!==void 0)return csrfModule;csrfModuleLoad??=import(resolveDefaultsPath("app/Middleware/Csrf.ts")).then((mod)=>{csrfModule=mod;return csrfModule}).catch(()=>{csrfModule=null;return null});return csrfModuleLoad}export function clearCsrfModuleCache(){csrfModule=void 0;csrfModuleLoad=void 0}function applyCsrfRenderToken(req,cookieHeader,mod){const token=mod.generateCsrfToken();req._csrfToken=token;try{const merged=cookieHeader?`${cookieHeader}; ${mod.CSRF_COOKIE_NAME}=${token}`:`${mod.CSRF_COOKIE_NAME}=${token}`;req.headers.set("cookie",merged)}catch{}}function requestMayRenderHtml(req){return req.headers.get("accept")?.includes("text/html")===!0||req.headers.get("sec-fetch-dest")==="document"}function cookieHeaderHasName(cookieHeader,name){const needle=`${name}=`;let at=cookieHeader.indexOf(needle);while(at!==-1){let before=at-1;while(before>=0&&cookieHeader.charCodeAt(before)===32)before--;if(before<0||cookieHeader.charCodeAt(before)===59)return!0;at=cookieHeader.indexOf(needle,at+1)}return!1}function hasCsrfCookie(cookieHeader){return cookieHeader.length!==0&&(cookieHeaderHasName(cookieHeader,"X-CSRF-Token")||cookieHeaderHasName(cookieHeader,"csrf-token"))}function seedCsrfTokenForRender(req,cookieHeader=req.headers?.get?.("cookie")??""){const mod=loadCsrfModule();if(mod===null)return;if(mod instanceof Promise)return mod.then((resolved)=>{if(!resolved)return;if(hasCsrfCookie(cookieHeader)){req._csrfToken=resolved.csrfCookieToken(req)||void 0;return}applyCsrfRenderToken(req,cookieHeader,resolved)});if(hasCsrfCookie(cookieHeader)){req._csrfToken=mod.csrfCookieToken(req)||void 0;return}applyCsrfRenderToken(req,cookieHeader,mod)}export function enhanceRequest(req,initializeRequestId=!0){const routeParams=req.params??{};req.params=routeParams;if(initializeRequestId&&!req._requestId)req._requestId=incomingRequestId(req)??generateRequestId();if(req[STACKS_REQUEST_ENHANCED]===!0)return req;applyRequestEnhancements(req,routeParams);const routerPrototype=Object.getPrototypeOf(req);let stacksPrototype=stacksRequestPrototypes.get(routerPrototype);if(!stacksPrototype){stacksPrototype=Object.assign(Object.create(routerPrototype),REQUEST_METHODS);Object.defineProperty(stacksPrototype,STACKS_REQUEST_ENHANCED,{value:!0});stacksRequestPrototypes.set(routerPrototype,stacksPrototype)}Object.setPrototypeOf(req,stacksPrototype);return req}const INVALID_REQUEST_ID_CHARACTER=/[^\w.:-]/;function incomingRequestId(req){try{const supplied=req.headers.get("x-request-id")?.trim();if(supplied&&supplied.length>=8&&supplied.length<=200&&!INVALID_REQUEST_ID_CHARACTER.test(supplied))return supplied}catch{}return}const REQUEST_ID_DIGITS="0123456789abcdefghijklmnopqrstuvwxyz",REQUEST_ID_SUFFIX_COUNT=36;function createRequestIdGenerator(){const prefix=crypto.randomUUID().replaceAll("-","").slice(0,16);let block=0,suffix=0,blockPrefix=`${prefix}-0`;return()=>{suffix++;if(suffix===REQUEST_ID_SUFFIX_COUNT){suffix=0;blockPrefix=`${prefix}-${(++block).toString(36)}`}return blockPrefix+REQUEST_ID_DIGITS[suffix]}}let generateRequestId=()=>{generateRequestId=createRequestIdGenerator();return generateRequestId()};function validationFieldErrors(error){const errors=error?.details?.errors;if(!errors||typeof errors!=="object"||Array.isArray(errors))return;const entries=Object.entries(errors);if(entries.length===0||!entries.every(([,messages])=>Array.isArray(messages)&&messages.every((m)=>typeof m==="string")))return;return errors}function createHandlerErrorResponse(error,req,handlerPath,router){if(router?.errorHandler)return Promise.reject(error);report(error,{label:`[Router] ${handlerPath}`});const rawStatus=error?.statusCode??error?.status,status=typeof rawStatus==="number"&&Number.isInteger(rawStatus)&&rawStatus>=400&&rawStatus<600?rawStatus:void 0,fieldErrors=status===422?validationFieldErrors(error):void 0;if(fieldErrors)return Promise.resolve(validationFailureResponse(fieldErrors));return createErrorResponse(error instanceof Error?error:Error(String(error)),req,{handlerPath,status})}function wrapHandler(handler,skipParsing=!1,handlerKey=""){if(isRouterAction(handler))return wrapAction(handler,handlerKey);if(typeof handler==="string"){const handlerPath=handler;return async(req)=>{try{if(!skipParsing){await parseRequestBody(req);req=enhanceRequest(req)}const pending=resolveStringHandler(handlerPath);return await(pending instanceof Promise?await pending:pending)(req)}catch(error){return await createHandlerErrorResponse(error,req,handlerPath)}}}const fn=handler;return(req)=>{const result=fn(req);if(result instanceof Promise)return result.then((value)=>formatResult(value,req));return formatResult(result,req)}}function addFormValue(body,key,value){if(!Object.hasOwn(body,key))body[key]=value;else if(Array.isArray(body[key]))body[key].push(value);else body[key]=[body[key],value]}async function parseRequestBody(req){if(req._bodyParsed)return;req._bodyParsed=!0;const contentType=req.headers.get("content-type")||"",mediaType=contentType.toLowerCase();try{if(contentType==="application/json"||JSON_CONTENT_TYPE.test(contentType)){const raw=await req.text();req._rawBody=raw;req._rawBodyContentType=contentType;if(raw.length===0)req.jsonBody={};else try{const body=JSON.parse(raw);req.jsonBody=body&&typeof body==="object"?body:{}}catch(parseErr){const message=parseErr instanceof Error?parseErr.message:"Invalid JSON",{HttpError}=routerHttpErrorModule??=await import("@stacksjs/error-handling/http-error");throw new HttpError(400,`Invalid JSON body: ${message}`)}}else if(mediaType.includes("application/x-www-form-urlencoded")){const text=await req.clone().text(),params=new URLSearchParams(text),formBody=Object.create(null);params.forEach((value,key)=>{addFormValue(formBody,key,value)});req.formBody=formBody}else if(mediaType.includes("multipart/form-data")){const formData=await req.clone().formData(),formBody=Object.create(null),files={};formData.forEach((value,key)=>{if(value instanceof File)if(files[key])if(Array.isArray(files[key]))files[key].push(value);else files[key]=[files[key],value];else files[key]=value;else addFormValue(formBody,key,value)});Reflect.set(req,"formBody",formBody);Reflect.set(req,"files",files)}}catch(e){if(typeof(e?.status??e?.statusCode)==="number")throw e;log.debug("[stacks-router] Body parsing failed:",e)}}let signedStorageModule;function isActiveContentType(contentType){const type=contentType.split(";")[0].trim().toLowerCase();return type==="text/html"||type==="application/xhtml+xml"||type==="image/svg+xml"||type==="text/xml"||type==="application/xml"||type.endsWith("+xml")||type==="text/javascript"||type==="application/javascript"||type==="application/ecmascript"}function attachmentDisposition(path){const name=path.split("/").pop()||"download";return`attachment; filename="${name.replace(/[^\x20-\x7E]|["\\]/g,"_")}"; filename*=UTF-8''${encodeURIComponent(name)}`}async function answerPreflight(req){try{const cors=await import(resolveDefaultsPath("app/Middleware/Cors.ts"));return cors.buildPreflightResponse(req,cors.getResolvedCorsConfig())}catch(error){log.warn("[router] CORS preflight could not load the CORS policy; answering without CORS headers",{error});return new Response(null,{status:204})}}export function createStacksRouter(config={}){const bunRouter=new Router({verbose:config.verbose??!1,preflight:answerPreflight});if(config.autoDiscoverRoutes===!1)bunRouter._apiRoutesInitialized=!0;const requestContextEnabled=config.requestContext!==!1;setAmbientRequestContext(requestContextEnabled);if(!requestContextEnabled)routersWithoutRequestContext.add(bunRouter);const csrfEnabled=config.csrf!==!1;if(csrfEnabled)csrfEnabledNativeRouteRouters.add(bunRouter);fuseRequestEnhancements(bunRouter,config.requestIds!==!1);let currentPrefix="",currentGroupMiddleware=[],currentGroupApiResponse=!1;const routeStates=new Map;function registerRoute(method,path,_handler){const fullPath=currentPrefix+braceParams(path),routeKey=`${method}:${fullPath}`,handlerKind=_handler instanceof Response?"static response":typeof _handler==="string"?_handler:"function";log.debug(`[router] ${method} ${fullPath} \u2192 ${handlerKind}`);const withheldBecause=routeAdmission&&typeof _handler==="string"?routeAdmission(_handler):void 0;if(withheldBecause){withheldRoutes.push({method,path:fullPath,handler:_handler,reason:withheldBecause});return{fullPath,routeKey,shadowed:!0,withheld:!0}}const shadowed=routeStates.has(routeKey)||clearedRouteKeysByRegistry.get(routeStates)?.has(routeKey)===!0;if(!shadowed){const routeState={csrfMode:CSRF_DEFAULT};if(currentGroupMiddleware.length>0)routeState.middleware=[...currentGroupMiddleware];routeStates.set(routeKey,routeState);routeStateRegistries.add(routeStates)}if(!shadowed&&currentGroupApiResponse)(routeApiResponseRegistry??=new Set).add(routeKey);if(!shadowed&&typeof _handler==="string")routeHandlerKeyRegistry.set(routeKey,_handler);if(!shadowed&&isRouterAction(_handler))(routeActionRegistry??=new Map).set(routeKey,_handler);return{fullPath,routeKey,shadowed,withheld:!1}}const stacksRouter={bunRouter,get routes(){return bunRouter.routes},staticResponse(method,path,response){if(!STATIC_RESPONSE_METHODS.has(method))throw TypeError(`[Router] staticResponse(): unsupported HTTP method '${String(method)}'`);if(!(response instanceof Response))throw TypeError("[Router] staticResponse(): response must be a prebuilt Response");if(currentGroupMiddleware.length>0)throw Error("[Router] staticResponse() cannot be registered inside a group with middleware because static responses bypass middleware");if(currentGroupApiResponse)throw Error("[Router] staticResponse() cannot be registered inside a group with apiResponse because static responses bypass response formatting");const{fullPath,shadowed}=registerRoute(method,path,response);if(!shadowed)switch(method){case"GET":bunRouter.get(fullPath,response);break;case"POST":bunRouter.post(fullPath,response);break;case"PUT":bunRouter.put(fullPath,response);break;case"PATCH":bunRouter.patch(fullPath,response);break;case"DELETE":bunRouter.delete(fullPath,response);break;case"OPTIONS":bunRouter.options(fullPath,response);break}return stacksRouter},get(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("GET",path,handler);if(!withheld)bunRouter.get(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},post(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("POST",path,handler);if(!withheld)bunRouter.post(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},put(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("PUT",path,handler);if(!withheld)bunRouter.put(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},patch(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("PATCH",path,handler);if(!withheld)bunRouter.patch(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},delete(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("DELETE",path,handler);if(!withheld)bunRouter.delete(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},options(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("OPTIONS",path,handler);if(!withheld)bunRouter.options(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},redirect(from,to,status=302){if(!REDIRECT_STATUSES.has(status))throw TypeError(`[Router] redirect(): ${status} is not a redirect status (use 301, 302, 303, 307 or 308)`);if(!to)throw TypeError(`[Router] redirect(): '${from}' needs somewhere to go`);const handler=(request)=>{const search=new URL(request.url).search,location=search&&!to.includes("?")?`${to}${search}`:to;return new Response(null,{status,headers:{Location:location}})},{fullPath,routeKey,shadowed}=registerRoute("GET",from,handler);bunRouter.get(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));if(!shadowed)(redirectRouteRegistry??=new Map).set(fullPath,{path:fullPath,to,status});return createChainableRoute(routeStates,routeKey,shadowed)},permanentRedirect(from,to){return stacksRouter.redirect(from,to,301)},group(options,callback){const previousPrefix=currentPrefix,previousMiddleware=[...currentGroupMiddleware],previousApiResponse=currentGroupApiResponse,restoreGroupState=()=>{currentPrefix=previousPrefix;currentGroupMiddleware=previousMiddleware;currentGroupApiResponse=previousApiResponse};if(options.prefix)currentPrefix=previousPrefix+braceParams(options.prefix);const middlewareList=options.middleware?Array.isArray(options.middleware)?options.middleware:[options.middleware]:void 0;if(middlewareList)currentGroupMiddleware=[...currentGroupMiddleware,...middlewareList];if(options.apiResponse===!0)currentGroupApiResponse=!0;log.debug(`[router] Entering group: prefix=${options.prefix||"/"} middleware=[${middlewareList?.join(", ")||""}]${currentGroupApiResponse?" apiResponse=true":""}`);let result;try{result=callback()}catch(error){restoreGroupState();throw error}if(result instanceof Promise)return result.then(()=>stacksRouter).finally(restoreGroupState);restoreGroupState();return stacksRouter},resource(name,handler,options){const actions=["index","store","show","update","destroy"],activeActions=options?.only?actions.filter((a)=>options.only.includes(a)):options?.except?actions.filter((a)=>!options.except.includes(a)):actions,stripped=handler.replace(/Action$/,""),handlerBase=stripped.startsWith("Actions/")?stripped:`Actions/${stripped}`;log.debug(`[router] Resource: /${name} \u2192 ${handlerBase}*Action [${activeActions.join(", ")}]`);const sibling=(suffix)=>`${handlerBase}${suffix}`,registerResourceRoutes=()=>{for(const action of activeActions)switch(action){case"index":stacksRouter.get(`/${name}`,sibling("IndexAction"));break;case"store":stacksRouter.post(`/${name}`,sibling("StoreAction"));break;case"show":stacksRouter.get(`/${name}/:id`,sibling("ShowAction"));break;case"update":stacksRouter.put(`/${name}/:id`,sibling("UpdateAction"));break;case"destroy":stacksRouter.delete(`/${name}/:id`,sibling("DestroyAction"));break}};if(options?.middleware)stacksRouter.group({middleware:options.middleware},registerResourceRoutes);else registerResourceRoutes();return stacksRouter},match(methods,path,handler){log.debug(`[router] Match: [${methods.join(", ")}] ${path} \u2192 ${typeof handler==="string"?handler:"function"}`);const routeKeys=[];for(const method of methods){const m=method.toUpperCase(),{fullPath,routeKey,shadowed,withheld}=registerRoute(m,path,handler);if(withheld)continue;if(!shadowed)routeKeys.push(routeKey);const wrappedHandler=createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled);switch(m){case"GET":bunRouter.get(fullPath,wrappedHandler);break;case"POST":bunRouter.post(fullPath,wrappedHandler);break;case"PUT":bunRouter.put(fullPath,wrappedHandler);break;case"PATCH":bunRouter.patch(fullPath,wrappedHandler);break;case"DELETE":bunRouter.delete(fullPath,wrappedHandler);break;case"OPTIONS":bunRouter.options(fullPath,wrappedHandler);break}}return createChainableRoute(routeStates,routeKeys[0]??"",routeKeys.length===0,routeKeys.slice(1))},health(){bunRouter.get("/api/health",async()=>{const{checkApplicationHealth}=await import("./health"),health=await checkApplicationHealth();return Response.json(health,{status:health.status==="healthy"?200:503})});bunRouter.get("/__routes",(req)=>{if(!isExposeRoutesAuthorized(req))return Response.json({error:"disabled"},{status:404});return Response.json(listRegisteredRoutes())});bunRouter.get("/__storage/{path}",async(req)=>{const url=new URL(req.url),token=url.searchParams.get("token"),params=req.params,rawPath=params?.path?params.path:decodeURIComponent(url.pathname.replace(/^\/__storage\//,""));if(!token||typeof rawPath!=="string"||rawPath.length===0)return new Response("Forbidden",{status:403});const{verifySignedStorageToken,Storage}=signedStorageModule??=await import("@stacksjs/storage"),v=verifySignedStorageToken(token,rawPath);if(!v.valid)return new Response("Forbidden",{status:403});try{let adapter;if(v.claims?.disk)try{adapter=Storage.disk(v.claims.disk)}catch{return new Response("Not Found",{status:404})}else adapter=Storage.disk();if(!await adapter.fileExists(rawPath))return new Response("Not Found",{status:404});const buf=await adapter.readToBuffer(rawPath),mime=await adapter.mimeType(rawPath).catch(()=>"application/octet-stream"),headers={"Content-Type":mime,"Cache-Control":"private, max-age=60","X-Content-Type-Options":"nosniff"};if(isActiveContentType(mime)){headers["Content-Disposition"]=attachmentDisposition(rawPath);headers["Content-Security-Policy"]="sandbox"}return new Response(buf,{status:200,headers})}catch(err){log.error("[storage] signed-url fetch failed:",err);return new Response("Internal Error",{status:500})}});bunRouter.get("/__openapi.json",async(req)=>{if(!isExposeRoutesAuthorized(req))return Response.json({error:"disabled"},{status:404});try{const{generateOpenApi}=await import("@stacksjs/api"),spec=await generateOpenApi({write:!1,portable:!1});return Response.json(spec)}catch(err){return Response.json({error:"OpenAPI generation failed",message:err instanceof Error?err.message:String(err)},{status:500})}});return stacksRouter},use(middleware){const adapted=adaptMiddlewareForBunRouter(middleware);bunRouter.globalMiddleware.push(adapted);return stacksRouter},booting(name,run){bootHooks.push({name,run});return stacksRouter},stopping(name,run){shutdownHooks().hooks.push({name,run});return stacksRouter},async serve(options={}){const{overridesReady}=await import("@stacksjs/config");await overridesReady;if(requestCaptureEnabled()&&!shutdownHooks().hooks.some((hook)=>hook.name==="http-capture"))shutdownHooks().hooks.push({name:"http-capture",run:flushRequestCaptures});warnOnMultipleRouterInstances();configureViewDirectories(bunRouter);if(csrfEnabled)wrapHandleRequestForCsrf(bunRouter);await wrapHandleRequestForDatabaseContext(bunRouter);await runBootHooks();const production=(process.env.APP_ENV??"").toLowerCase()==="production"||process.env.NODE_ENV==="production",callerSuppliedRoutes=Object.prototype.hasOwnProperty.call(options,"routes"),nativeRoutes=options.nativeRoutes??(production&&!callerSuppliedRoutes&&shouldUseNativeRoutesByDefault(bunRouter.routes));if(options.tls)secureNativeRouteRouters.add(bunRouter);else secureNativeRouteRouters.delete(bunRouter);return bunRouter.serve(nativeRoutes===options.nativeRoutes?options:{...options,nativeRoutes})},handleRequest(req){return requestCaptureEnabled()?observeHttpRequest(req,()=>bunRouter.handleRequest(req)):bunRouter.handleRequest(req)},getAllowedMethods(pathname,domain){return bunRouter.getAllowedMethods(pathname,domain)},async register(routePath,options){log.debug(`[router] Register: ${routePath} prefix=${options?.prefix||"none"}`);const callback=async()=>{await import(routePath)};if(options?.prefix||options?.middleware)await stacksRouter.group({prefix:options.prefix,middleware:options.middleware},callback);else await callback();return stacksRouter},async importRoutes(){log.debug("[router] Loading user routes from registry...");try{const{appRouteRegistry,loadRoutes}=await import("./route-loader");await loadRoutes(await appRouteRegistry())}catch(error){log.error("Failed to load route registry:",error);throw error}log.debug("[router] Loading ORM routes...");const ormRoutesPackage="@stacksjs/orm/routes";let ormRoutesLoaded=!1;try{await import(ormRoutesPackage);ormRoutesLoaded=!0;log.debug(`[router] ORM routes loaded from ${ormRoutesPackage}`)}catch(error){log.debug(`[router] ORM routes not available from the package, trying the vendored copy
5
- `,error)}const ormRoutesCandidates=ormRoutesLoaded?[]:[frameworkPath("orm/routes.ts"),frameworkPath("core/orm/routes.ts")];for(const candidate of ormRoutesCandidates)try{if(await Bun.file(candidate).exists()){await import(candidate);ormRoutesLoaded=!0;log.info(`[router] ORM routes loaded from the vendored copy at ${candidate}. This file is not refreshed by upgrading @stacksjs/orm - delete it to use the package.`);break}}catch(error){log.warn(`[router] ORM routes candidate failed to load, falling back to next: ${candidate}
6
- `,error)}if(!ormRoutesLoaded)log.warn("[router] No ORM routes candidate loaded - model useApi endpoints are unavailable.");log.debug("[router] Loading discovered package routes...");try{await stacksRouter.loadDiscoveredRoutes()}catch(error){log.debug("Package route discovery skipped:",error)}await assertRouteMiddlewareResolvable()},async loadDiscoveredRoutes(){try{const manifestPath=storagePath("framework/discovered-packages.json"),file=Bun.file(manifestPath);if(!await file.exists())return;const packages=(await file.json())?.packages;if(!packages)return;for(const[pkgName,meta]of Object.entries(packages)){const routes=meta?.routes;if(!routes)continue;const routeList=Array.isArray(routes)?routes:[routes],pkgDir=meta?.root?projectPath(meta.root):`${projectPath("pantry")}/${pkgName}`;for(const routeFile of routeList){log.debug(`[router] Discovered route: ${pkgName} \u2192 ${routeFile}`);const fullPath=routeFile.startsWith("/")?routeFile:`${pkgDir}/${routeFile}`,prefix=meta?.routePrefix,middleware=meta?.routeMiddleware;try{await stacksRouter.register(fullPath,{prefix,middleware})}catch(err){log.warn(`Failed to load routes from package '${pkgName}': ${err}`)}}}}catch{}}};return stacksRouter}function wrapHandleRequestForCsrf(bunRouter){const router=bunRouter;if(router._csrfSeedingWrapped)return;const original=router.handleRequest.bind(router),handleUnseededSafeRequest=async(request,rendersCsrf,cookieHeader)=>{if(rendersCsrf&&requestMayRenderHtml(request)){const seeding=seedCsrfTokenForRender(request,cookieHeader);if(seeding)await seeding}request[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;const response=await original(request);if(!response)return response;try{const mod=loadCsrfModule(),csrf=mod instanceof Promise?await mod:mod;if(!csrf)return response;return csrf.seedCsrfCookieIfMissing(request,response,request._csrfToken)}catch(err){log.warn("[router] CSRF cookie seeding failed on the view path",{error:err});return response}},handleSafeRequest=(request,rendersCsrf)=>{const cookieHeader=request.headers.get("cookie")??"";if(hasCsrfCookie(cookieHeader)){if(rendersCsrf&&requestMayRenderHtml(request)){const seeding=seedCsrfTokenForRender(request,cookieHeader);if(seeding)return seeding.then(()=>{request[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;return original(request)})}request[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;return original(request)}return handleUnseededSafeRequest(request,rendersCsrf,cookieHeader)};router.handleRequest=(request)=>{const method=request.method;if(method==="GET"||method==="HEAD")return handleSafeRequest(request,!0);if(method==="OPTIONS")return handleSafeRequest(request,!1);return original(request)};router._csrfSeedingWrapped=!0}export function configureViewDirectories(bunRouter){const router=bunRouter;if(typeof router.views!=="function")return;const existing=router._fileRoutingConfig;if(existing&&Object.keys(existing).length>0)return;if(!existsSync(projectPath("resources/views")))return;const layouts=[projectPath("resources/views/layouts"),projectPath("resources/layouts")].find(existsSync),partials=[projectPath("resources/views/partials"),projectPath("resources/partials")].find(existsSync),components=[projectPath("resources/components"),projectPath("resources/views/components")].find(existsSync);router.views({...components?{componentsDir:components}:{},...layouts?{layoutsDir:layouts}:{},...partials?{partialsDir:partials}:{}})}export function disableViewRouting(bunRouter){const router=bunRouter;if(typeof router.disableFileRouting!=="function")return!1;const existing=router._fileRoutingConfig;if(existing&&Object.keys(existing).length>0)return!1;router.disableFileRouting();return!0}const ROUTE_SINGLETON_KEY=Symbol.for("@stacksjs/router:route-singleton");export const route=globalThis[ROUTE_SINGLETON_KEY]??=createStacksRouter();let routesLoadPromise=null,routingContextDispatcher=null;const databaseContextWrappedRouters=new WeakSet;function applyDirectNativeCookies(router,response,request){const cookieChanges=request;return cookieChanges._cookiesToSet?.length||cookieChanges._cookiesToDelete?.length?router.applyModifiedCookies(response,request):response}function nativeRouteErrorResponse(error){return new Response(JSON.stringify({success:!1,message:"Internal Server Error",error:error instanceof Error?error.message:String(error)}),{status:500,headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, PUT, DELETE, PATCH, OPTIONS","Access-Control-Allow-Headers":"Content-Type, Authorization, X-Requested-With, Accept, Origin"}})}function handleDirectNativeRouteError(router,error){console.error("Error handling request:",error);return router.errorHandler?router.errorHandler(error instanceof Error?error:Error(String(error))):nativeRouteErrorResponse(error)}function directNativePath(path){const segments=path.split("/");for(let index=0;index<segments.length;index++){const segment=segments[index];if(!segment)continue;const parameter=segment.match(/^\{([A-Z_$][\w$]*)\}$/i);if(parameter){segments[index]=`:${parameter[1]}`;continue}if(segment.includes("{")||segment.includes(":")||segment.includes("*"))return}return segments.join("/")}function buildDirectNativeHandlers(router,finalizeResponse){const nativeRouter=router,handlers=new Map;if(nativeRouter.globalMiddleware.length!==0)return handlers;const enterBunRouterContext=routersWithoutRequestContext.has(router)?(_req,fn)=>fn():runWithBunRouterRequest;for(const route of nativeRouter.routes){if(!isNativeRouteMethod(route.method)||route.nativeDispatch===!1||route.constraints&&Object.keys(route.constraints).length>0||(route.middleware?.length??0)!==0||typeof route.handler!=="function"||!stacksRouteHandlers.has(route.handler))continue;const handler=route.handler,nativePath=directNativePath(route.path);if(!nativePath)continue;const key=`${route.method}:${nativePath}`;if(handlers.has(key))continue;handlers.set(key,(request)=>{const nativeParams=request.params??{},enhancedRequest=nativeRouter.enhanceRequest(request,nativeParams);enhancedRequest.route=route;const requestMarkers=enhancedRequest;if(typeof requestMarkers[CSRF_SECURE_TRANSPORT]!=="boolean")requestMarkers[NATIVE_DIRECT_ROUTE_REQUEST]=!0;return enterBunRouterContext(enhancedRequest,()=>{try{const response=handler(enhancedRequest);return response instanceof Response?finalizeResponse(applyDirectNativeCookies(nativeRouter,response,enhancedRequest),request):response.then((result)=>finalizeResponse(applyDirectNativeCookies(nativeRouter,result,enhancedRequest),request),(error)=>{const result=handleDirectNativeRouteError(nativeRouter,error);return result instanceof Response?finalizeResponse(result,request):result.then((response)=>finalizeResponse(response,request))})}catch(error){const result=handleDirectNativeRouteError(nativeRouter,error);return result instanceof Response?finalizeResponse(result,request):result.then((response)=>finalizeResponse(response,request))}})})}return handlers}function wrapNativeRoutesForDatabaseContext(router,dispatchInRoutingContext){const nativeRouter=router;if(nativeRouter._nativeDatabaseContextWrapped||typeof nativeRouter._buildNativeRoutes!=="function")return;const buildNativeRoutes=nativeRouter._buildNativeRoutes.bind(nativeRouter);nativeRouter._buildNativeRoutes=()=>{const routes=buildNativeRoutes();if(!routes)return routes;const compression=nativeRouter.config.compression,compressionDisabled=compression?.enabled===!1,compressionThreshold=compression?.threshold??1024,finalizeResponse=(response,request)=>{const bodySizeUpperBound=response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND];if(compressionDisabled||typeof bodySizeUpperBound==="number"&&bodySizeUpperBound<compressionThreshold)return response;if(bodySizeUpperBound===void 0){const declaredLength=response.headers.get("content-length");if(declaredLength!==null){const length=Number(declaredLength);if(Number.isSafeInteger(length)&&length>=0&&length<compressionThreshold)return response}}return applyResponseCompression(response,request,compression)},directHandlers=buildDirectNativeHandlers(router,finalizeResponse),secureTransport=secureNativeRouteRouters.has(router),csrfEnabled=csrfEnabledNativeRouteRouters.has(router);for(const[path,methods]of Object.entries(routes))for(const[method,handler]of Object.entries(methods)){const safeMethod=method==="GET"||method==="HEAD"||method==="OPTIONS",directDispatch=directHandlers.get(`${method}:${path}`)??(method==="HEAD"?directHandlers.get(`GET:${path}`):void 0);if(directDispatch){if(safeMethod&&csrfEnabled)methods[method]=(request)=>{const cookie=request.headers.get("cookie")??"",markedRequest=request;if(hasCsrfCookie(cookie))markedRequest[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;else markedRequest[CSRF_SECURE_TRANSPORT]=secureTransport;return dispatchInRoutingContext(directDispatch,request)};else methods[method]=(request)=>dispatchInRoutingContext(directDispatch,request);continue}methods[method]=(request)=>{if(safeMethod&&csrfEnabled){const cookie=request.headers.get("cookie")??"",markedRequest=request;if(hasCsrfCookie(cookie))markedRequest[CSRF_SEEDED_BY_HANDLE_REQUEST]=!0;else markedRequest[CSRF_SECURE_TRANSPORT]=secureTransport}const response=dispatchInRoutingContext(handler,request);return response instanceof Response?finalizeResponse(response,request):response.then((resolved)=>finalizeResponse(resolved,request))}}if(requestCaptureEnabled())for(const methods of Object.values(routes))for(const[method,handler]of Object.entries(methods))methods[method]=(request)=>observeHttpRequest(request,()=>handler(request));return routes};nativeRouter._nativeDatabaseContextWrapped=!0}async function wrapHandleRequestForDatabaseContext(router){if(databaseContextWrappedRouters.has(router))return;const dispatchInRoutingContext=await getRoutingContextDispatcher();if(databaseContextWrappedRouters.has(router))return;wrapNativeRoutesForDatabaseContext(router,dispatchInRoutingContext);const original=router.handleRequest.bind(router);router.handleRequest=(request)=>requestCaptureEnabled()?observeHttpRequest(request,()=>dispatchInRoutingContext(original,request)):dispatchInRoutingContext(original,request);databaseContextWrappedRouters.add(router)}async function getRoutingContextDispatcher(){if(!routingContextDispatcher)try{let database=await import("@stacksjs/database/replicas");if(typeof database.runInDatabaseRoutingContext!=="function"&&typeof database.withDatabaseRoutingContext!=="function")database=await import("@stacksjs/database/runtime");const dispatcher=database.runInDatabaseRoutingContext,runner=database.withDatabaseRoutingContext??database.withRoutingContext;routingContextDispatcher=typeof dispatcher==="function"?dispatcher:typeof runner==="function"?(fn,arg)=>runner(()=>fn(arg)):(fn,arg)=>fn(arg)}catch{routingContextDispatcher=(fn,arg)=>fn(arg)}return routingContextDispatcher}export function serverResponse(request,_body){if(routingContextDispatcher)return routingContextDispatcher(handleServerRequest,request);return dispatchServerRequestAfterContextInit(request)}async function dispatchServerRequestAfterContextInit(request){return(await getRoutingContextDispatcher())(handleServerRequest,request)}let handleServerRequest=handleServerRequestBeforeRoutes;async function handleServerRequestBeforeRoutes(request){if(!routesLoadPromise){log.debug("[router] Loading routes for first time...");routesLoadPromise=route.importRoutes().catch((err)=>{routesLoadPromise=null;throw err})}await routesLoadPromise;handleServerRequest=handleLoadedServerRequest;return handleLoadedServerRequest(request)}async function handleLoadedServerRequest(request){const response=await route.handleRequest(request);if(response[ENRICHED_NOT_FOUND_RESPONSE]===!0)return response;if(response.status===404&&response.headers.get("content-type")?.includes("json"))try{const path=new URL(request.url).pathname,method=request.method,text=await response.clone().text();if(text===JSON.stringify({success:!1,message:"Not Found",path,method})||text===JSON.stringify({error:"Not Found",path,method}))return response;const body=JSON.parse(text);if(body?.message==="Not Found"||body?.error==="Not Found"){const enriched={...body,path,method};return new Response(JSON.stringify(enriched),{status:404,headers:response.headers})}}catch{}return response}export async function serve(options={}){return route.serve(options)}
1
+ import{applyRequestEnhancements,applyResponseCompression,ENRICHED_NOT_FOUND_RESPONSE,response,Router,runWithRequest as runWithBunRouterRequest}from"@stacksjs/bun-router/runtime";import"./request-augmentation";import{flushRequestCaptures,observeHttpRequest,requestCaptureEnabled}from"./request-capture";import process from"node:process";import{Buffer}from"node:buffer";import{existsSync,lstatSync,statSync}from"node:fs";import{isAbsolute,relative,sep}from"node:path";import{log,report}from"@stacksjs/logging/runtime";import{appPath,frameworkPath,projectPath,storagePath}from"@stacksjs/path/project";import{resolveModulePath}from"@stacksjs/path/module-resolution";const DATABASE_QUERY_TRACKER_KEY=Symbol.for("stacks.database.queryTracker");const queryTrackerGlobal=globalThis;const loadQueryTracker=(...args)=>{const{trackQuery}=require("./query-tracking");queryTrackerGlobal[DATABASE_QUERY_TRACKER_KEY]=trackQuery;trackQuery(...args)};queryTrackerGlobal[DATABASE_QUERY_TRACKER_KEY]=loadQueryTracker;const ROUTER_INSTANCES_KEY=Symbol.for("@stacksjs/router:loaded-instances");const loadedRouterInstances=globalThis[ROUTER_INSTANCES_KEY]??=new Set;loadedRouterInstances.add(import.meta.path);const MULTI_INSTANCE_WARNED_KEY=Symbol.for("@stacksjs/router:multi-instance-warned");const bootHooks=[];let bootHooksRun=false;export async function runBootHooks(){if(bootHooksRun)return;bootHooksRun=true;for(const hook of bootHooks){try{await hook.run()}catch(error){log.error(`[router] boot hook "${hook.name}" failed:`,error)}}}export function resetBootHooks(){bootHooks.length=0;bootHooksRun=false}const SHUTDOWN_HOOKS_KEY=Symbol.for("@stacksjs/router:shutdown-hooks");function shutdownHooks(){return globalThis[SHUTDOWN_HOOKS_KEY]??={hooks:[]}}export function runShutdownHooks(){const state=shutdownHooks();state.running??=Promise.all(state.hooks.map(async(hook)=>{try{await hook.run()}catch(error){await log.error(`[router] shutdown hook "${hook.name}" failed:`,error)}})).then(()=>{});return state.running}export function resetShutdownHooks(){const state=shutdownHooks();state.hooks.length=0;state.running=undefined}export function warnOnMultipleRouterInstances(){if(loadedRouterInstances.size<=1)return false;const g=globalThis;if(!g[MULTI_INSTANCE_WARNED_KEY]){g[MULTI_INSTANCE_WARNED_KEY]=true;const paths=[...loadedRouterInstances].map((p)=>` - ${p}`).join(`
2
+ `);log.warn(`${loadedRouterInstances.size} distinct @stacksjs/router modules loaded in one process; they now share one route `+`table (stacksjs/stacks#1982) so routing still works, but this is a duplicated install worth fixing. It usually `+`means an app vendors storage/framework/core AND installs the published @stacksjs/* dist, and a tsconfig \`paths\` `+`mapping (\`@stacksjs/* -> ./*/src\`) splits module resolution between core files and root files. See stacksjs/stacks#1975.
3
+ `+`Loaded instances:
4
+ ${paths}`)}return true}let __defaultsPkgRoot;let __defaultsPathCache;function resolveDefaultsPath(rel){const cached=__defaultsPathCache?.get(rel);if(cached!==undefined)return cached;if(rel.startsWith("app/")){const published=appPath(rel.slice("app/".length));if(existsSync(published)){const cache=__defaultsPathCache??=new Map;cache.set(rel,published);return published}}const vendored=storagePath(`framework/defaults/${rel}`);let resolved;if(existsSync(vendored)){resolved=vendored}else{if(__defaultsPkgRoot===undefined){try{const pkgJson=Bun.resolveSync("@stacksjs/defaults/package.json",process.cwd());__defaultsPkgRoot=pkgJson.slice(0,pkgJson.lastIndexOf("/"))}catch{__defaultsPkgRoot=null}}resolved=__defaultsPkgRoot?`${__defaultsPkgRoot}/${rel}`:vendored}const cache=__defaultsPathCache??=new Map;cache.set(rel,resolved);return resolved}const NATIVE_ROUTE_PARAM=/^\{[A-Z_$][\w$]*\}$/i;function isNativeRouteMethod(method){return method==="GET"||method==="POST"||method==="PUT"||method==="PATCH"||method==="DELETE"||method==="OPTIONS"||method==="HEAD"}function hasNativeCompatiblePath(path){if(path==="*")return true;const segments=path.split("/");for(let index=0;index<segments.length;index++){const segment=segments[index];if(segment===""||NATIVE_ROUTE_PARAM.test(segment))continue;if(segment==="*"&&index===segments.length-1)continue;if(segment.includes("{")||segment.includes(":")||segment.includes("*"))return false}return true}export function shouldUseNativeRoutesByDefault(routes){let hasEligibleRoute=false;for(const route of routes){if(!isNativeRouteMethod(route.method)||route.handler instanceof Response)continue;hasEligibleRoute=true;if(route.nativeDispatch===false||route.domain||route.constraints&&Object.keys(route.constraints).length>0||!hasNativeCompatiblePath(route.path))return false}return hasEligibleRoute}import{runWithRequestArgument,runWithRequestArguments,setAmbientRequestContext}from"./request-context";import{isApiRequest,JSON_CONTENT_TYPE}from"./api-shape";import{applySecurityHeaders,createJsonSecurityHeaders,secureSerializedJsonResponse}from"./security-headers";import{isCursorPaginator,isPaginator,isSimplePaginator}from"@stacksjs/pagination";let errorHandlerModule;let errorHandlerModuleLoad;async function loadErrorHandlerModule(){return errorHandlerModule??=await(errorHandlerModuleLoad??=import("./error-handler"))}async function createErrorResponse(...args){return(await loadErrorHandlerModule()).createErrorResponse(...args)}async function createMiddlewareErrorResponse(...args){return(await loadErrorHandlerModule()).createMiddlewareErrorResponse(...args)}function bindAsyncRouteHandler(handler){return(req,preparedBaseResult,hasPreparedBaseResult=false)=>runWithRequestArguments(req,handler,req,preparedBaseResult,hasPreparedBaseResult)}const stacksRouteHandlers=new WeakSet;function rememberStacksRouteHandler(handler){stacksRouteHandlers.add(handler);return handler}function invokeInlineHandler(req,handler,_unused){const result=handler(req);if(result instanceof Promise)return result.then((value)=>formatResult(value,req));return formatResult(result,req)}const STATIC_RESPONSE_METHODS=new Set(["GET","POST","PUT","PATCH","DELETE","OPTIONS"]);const CSRF_DEFAULT=0;const CSRF_SKIPPED=1;const CSRF_REQUIRED=2;const ROUTE_ACCEPTS_CSRF=1;const ROUTE_MAY_HAVE_BODY=2;const ROUTE_RENDERS_CSRF=4;const ROUTE_SEEDS_CSRF=8;const ROUTE_FORCES_JSON=16;const ROUTE_ACTION_SKIPS_CSRF=32;const routeStateRegistries=new Set;const clearedRouteKeysByRegistry=new WeakMap;let routeAdmission;let withheldRoutes=[];export async function withRouteAdmission(admit,register){const previous=routeAdmission;const previousWithheld=withheldRoutes;routeAdmission=admit;withheldRoutes=[];try{await register();return withheldRoutes}finally{routeAdmission=previous;withheldRoutes=previousWithheld}}function rateLimitWindowToSeconds(window){if(typeof window==="number"){if(!Number.isFinite(window)||window<=0){throw new Error(`[Router] .rateLimit(): window must be a positive number of seconds, got ${window}`)}return Math.floor(window)}switch(window){case"second":return 1;case"minute":return 60;case"hour":return 3600;case"day":return 86400;default:throw new Error(`[Router] .rateLimit(): unknown period '${String(window)}'`)}}class BoundedMap{max;map;constructor(max){this.max=max}get(key){return this.map?.get(key)}has(key){return this.map?.has(key)??false}set(key,value){const map=this.map??=new Map;if(map.has(key))map.delete(key);map.set(key,value);if(map.size>this.max){const oldest=map.keys().next().value;if(oldest!==undefined)map.delete(oldest)}return this}delete(key){return this.map?.delete(key)??false}clear(){this.map=undefined}get size(){return this.map?.size??0}}function isExposeRoutesAuthorized(req){const flag=process.env.STACKS_EXPOSE_ROUTES??"";if(!flag){const env=(process.env.APP_ENV??"").toLowerCase();const isProd=env==="production"||process.env.NODE_ENV==="production";return!isProd}if(flag==="1"){const env=(process.env.APP_ENV??"").toLowerCase();const isProd=env==="production"||process.env.NODE_ENV==="production";return!isProd}const url=new URL(req.url);const submitted=req.headers.get("x-stacks-routes-token")||req.headers.get("X-Stacks-Routes-Token")||url.searchParams.get("token")||"";if(typeof submitted!=="string"||submitted.length===0||submitted.length!==flag.length)return false;try{const encoder=new TextEncoder;return crypto.timingSafeEqual(encoder.encode(submitted),encoder.encode(flag))}catch{return false}}let corsHeaderApplierCache={};let compressionApplierCache={};function applyCorsIfConfigured(req,response){if(!req._corsConfig||!response)return response;const cache=corsHeaderApplierCache;if(!cache.apply)return loadAndApplyCorsHeaders(req,response,cache);try{return cache.apply(req,response,req._corsConfig)}catch(err){log.warn("[router] CORS header injection failed",{error:err});return response}}async function loadAndApplyCorsHeaders(req,response,cache){try{const applyCorsHeaders=cache.apply??=(await import(resolveDefaultsPath("app/Middleware/Cors.ts"))).applyCorsHeaders;return applyCorsHeaders(req,response,req._corsConfig)}catch(err){log.warn("[router] CORS header injection failed",{error:err});return response}}const ACTION_CACHE_MAX=5000;const actionSkipsCsrfCache=new BoundedMap(ACTION_CACHE_MAX);const routeHandlerKeyRegistry=new BoundedMap(ACTION_CACHE_MAX);let routeActionRegistry;const CSRF_SEEDED_BY_HANDLE_REQUEST=Symbol.for("stacks.router.csrfSeededByHandleRequest");const FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND=Symbol("stacks.router.frameworkResponseBodySizeUpperBound");const NATIVE_DIRECT_ROUTE_REQUEST=Symbol("stacks.router.nativeDirectRouteRequest");const CSRF_SECURE_TRANSPORT=Symbol.for("@stacksjs/router:csrf-secure-transport");const secureNativeRouteRouters=new WeakSet;const csrfEnabledNativeRouteRouters=new WeakSet;const routersWithoutRequestContext=new WeakSet;const EMPTY_MIDDLEWARE_TIMINGS=[];const EMPTY_MIDDLEWARE_ENTRIES=[];const CSRF_ONLY_MIDDLEWARE=["csrf"];let resolvedMiddlewareEntryCache;let resolvedCsrfOnlyMiddleware;export async function withFallbackRouteNames(register){const applicationNames=new Map(namedRouteRegistry);try{await register()}finally{if(applicationNames.size){const registry=namedRouteRegistry??=new Map;for(const[name,definition]of applicationNames)registry.set(name,definition)}}}let namedRouteRegistry;const REDIRECT_STATUSES=new Set([301,302,303,307,308]);let redirectRouteRegistry;function compileNamedRoute(path){const paramNames=extractRouteParamNames(path);const colonRegex=new Map;for(const name of paramNames){colonRegex.set(name,new RegExp(`(^|/):${name}(?=$|/)`,"g"))}const optionalNames=[...new Set([...path.matchAll(/\{(\w+)\?\}/g)].map((m)=>m[1]))];return{path,paramNames,optionalNames,colonRegex}}function extractRouteParamNames(routePath){const names=new Set;for(const m of routePath.matchAll(/\{(\w+)\}/g)){if(m[1])names.add(m[1])}for(const m of routePath.matchAll(/(?:^|\/):(\w+)(?=$|\/)/g)){if(m[1])names.add(m[1])}return[...names]}function braceParams(path){return path.includes(":")?path.replace(/(^|\/):(\w+)(?=$|\/)/g,"$1{$2}"):path}export function url(routeName,params={}){const named=namedRouteRegistry?.get(routeName);if(!named){const availableRoutes=namedRouteRegistry?[...namedRouteRegistry.keys()].join(", "):"";throw new Error(`Route '${routeName}' is not defined. Available routes: ${availableRoutes}`)}const missing=named.paramNames.filter((name)=>!(name in params)||params[name]===undefined);if(missing.length>0){throw new Error(`url('${routeName}'): missing required path param${missing.length>1?"s":""} [${missing.join(", ")}] for path '${named.path}'. Pass them as the second argument: url('${routeName}', { ${named.paramNames.join(", ")} })`)}let appUrl;try{appUrl=process.env.APP_URL||"https://localhost"}catch{appUrl="https://localhost"}appUrl=appUrl.replace(/\/$/,"");if(!appUrl.startsWith("http")){appUrl=`https://${appUrl}`}let resolvedPath=named.path;const queryParams={};for(const[key,value]of Object.entries(params)){if(value===undefined)continue;const curly=`{${key}}`;const optional=`{${key}?}`;if(resolvedPath.includes(curly)){resolvedPath=resolvedPath.replaceAll(curly,encodeURIComponent(String(value)))}else if(resolvedPath.includes(optional)){resolvedPath=resolvedPath.replaceAll(optional,encodeURIComponent(String(value)))}else{const re=named.colonRegex.get(key);if(re&&re.test(resolvedPath)){re.lastIndex=0;resolvedPath=resolvedPath.replace(re,`$1${encodeURIComponent(String(value))}`)}else{queryParams[key]=String(value)}}}for(const name of named.optionalNames)resolvedPath=resolvedPath.replaceAll(`/{${name}?}`,"").replaceAll(`{${name}?}`,"");if(resolvedPath==="")resolvedPath="/";const queryString=Object.keys(queryParams).length>0?`?${new URLSearchParams(queryParams).toString()}`:"";return`${appUrl}${resolvedPath}${queryString}`}export function routeParams(routeName){const named=namedRouteRegistry?.get(routeName);return named?[...named.paramNames]:[]}export function listNamedRoutes(){const out={};if(namedRouteRegistry){for(const[name,named]of namedRouteRegistry)out[name]=named.path}return out}export function listRedirectRoutes(){return redirectRouteRegistry?[...redirectRouteRegistry.values()]:[]}export function listRegisteredRoutes(){const namesByPath=namedRouteRegistry?new Map:undefined;if(namesByPath&&namedRouteRegistry){for(const[name,named]of namedRouteRegistry){if(!namesByPath.has(named.path))namesByPath.set(named.path,name)}}const out=[];const seen=new Set;for(const registry of routeStateRegistries){for(const key of registry.keys()){if(seen.has(key))continue;seen.add(key);const idx=key.indexOf(":");if(idx===-1)continue;const method=key.slice(0,idx);const path=key.slice(idx+1);const routeName=namesByPath?.get(path);out.push({method,path,name:routeName,handler:routeHandlerKeyRegistry.get(key),action:routeActionRegistry?.get(key),middleware:registry.get(key)?.middleware})}}return out.sort((a,b)=>a.path.localeCompare(b.path))}const MIDDLEWARE_TIMEOUT_MS=30000;let _debugLoggingCache;function isDebugLogging(){if(_debugLoggingCache===undefined){const level=(process.env.LOG_LEVEL||"info").toLowerCase();_debugLoggingCache=level!=="info"&&level!=="warn"&&level!=="error"}return _debugLoggingCache}const DEFAULT_MIDDLEWARE_PRIORITY=10;let _warnedInvalidPriorities;function warnInvalidMiddlewarePriority(name,raw){const key=`${name}:${String(raw)}`;if(_warnedInvalidPriorities?.has(key))return;const warnedPriorities=_warnedInvalidPriorities??=new Set;warnedPriorities.add(key);log.warn(`[Router] Middleware '${name}' declared an invalid priority (${String(raw)}). Priorities must be a finite non-negative number; falling back to default ${DEFAULT_MIDDLEWARE_PRIORITY}.`)}function adaptMiddlewareForBunRouter(middleware){if(middleware&&typeof middleware==="object"&&typeof middleware.toRouterHandler==="function"){return middleware.toRouterHandler()}if(middleware&&typeof middleware==="object"&&typeof middleware.handle==="function"&&typeof middleware!=="function"){const handle=middleware.handle.bind(middleware);const wrapper=async(req,next)=>{try{await handle(req)}catch(thrown){if(thrown instanceof Response)return thrown;throw thrown}return next()};return wrapper}return middleware}let middlewareCache;let middlewareAliasesPromise=null;async function getMiddlewareAliases(){if(middlewareAliasesPromise)return middlewareAliasesPromise;middlewareAliasesPromise=(async()=>{const merged={};for(const load of[()=>import(resolveDefaultsPath("app/Middleware.ts")),()=>import(appPath("Middleware.ts"))]){try{const module=await load();Object.assign(merged,module.default??{})}catch{}}return merged})();return middlewareAliasesPromise}const PASCAL_SPLIT_REGEX=/[-_\s]+/;let pascalCaseCache;function toPascalCase(input){if(!input)return input;const cached=pascalCaseCache?.get(input);if(cached!==undefined)return cached;const out=input.split(PASCAL_SPLIT_REGEX).filter(Boolean).map((part)=>part.charAt(0).toUpperCase()+part.slice(1)).join("");const cache=pascalCaseCache??=new Map;cache.set(input,out);return out}async function resolveMiddlewareName(name){const aliases=await getMiddlewareAliases();const resolved=aliases[name]||toPascalCase(name);log.debug(`[middleware] Resolved: ${name} → ${resolved}`);return resolved}let middlewareRegistryPromise=null;async function getMiddlewareRegistry(){if(middlewareRegistryPromise)return middlewareRegistryPromise;middlewareRegistryPromise=(async()=>{const dir=storagePath("framework/auto-imports");const registryPath=`${dir}/middleware.ts`;if(!existsSync(registryPath))return null;const module=await import(registryPath);if(!module.middleware)throw new Error(`Invalid middleware registry: ${registryPath}`);return Object.fromEntries(Object.entries(module.middleware).map(([name,file])=>[name,resolveModulePath(file,dir)]))})();return middlewareRegistryPromise}async function loadMiddleware(name){const cachedMiddleware=middlewareCache??=new Map;if(cachedMiddleware.has(name)){return cachedMiddleware.get(name)??null}const className=await resolveMiddlewareName(name);const registry=await getMiddlewareRegistry();const registered=registry?.[className];if(registered){try{const middleware=await import(registered);const handler=middleware.default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${registered}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){log.error(`[Router] Failed to load middleware '${name}' from ${registered}:`,err);return null}}let userPathError;try{const userPath=appPath(`Middleware/${className}.ts`);const middleware=await import(userPath);const handler=middleware.default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${userPath}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){userPathError=err}try{const defaultPath=resolveDefaultsPath(`app/Middleware/${className}.ts`);const middleware=await import(defaultPath);const handler=middleware.default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' resolved to ${defaultPath}, but the file has no default export with a handle() method`);cachedMiddleware.set(name,null);return null}cachedMiddleware.set(name,handler);return handler}catch(err){const userMsg=userPathError instanceof Error?userPathError.message:String(userPathError);log.error(`[Router] Failed to load middleware '${name}' (resolved to '${className}'). app/Middleware: ${userMsg}; defaults:`,err);return null}}export async function middlewareAliases(){return{...await getMiddlewareAliases()}}export async function loadMiddlewareHandlers(){const aliases=await getMiddlewareAliases();const generated=await getMiddlewareRegistry();const references=new Set([...Object.keys(aliases),...Object.values(aliases),...Object.keys(generated??{})]);const handlers={};await Promise.all([...references].map(async(reference)=>{const handler=await loadMiddleware(reference);if(handler)handlers[reference]=handler}));return handlers}let negatedMiddlewareCache;let routerHttpErrorModule;function isShortCircuit(thrown){if(thrown instanceof Response)return true;return typeof thrown==="object"&&thrown!==null&&(("status"in thrown)||("statusCode"in thrown))}function negateMiddleware(name,inner,cache){const cached=cache.get(name);if(cached)return cached;const negated={priority:inner.priority,async handle(req){try{await inner.handle(req)}catch(thrown){if(isShortCircuit(thrown))return;throw thrown}const{HttpError}=routerHttpErrorModule??=await import("@stacksjs/error-handling/http-error");throw new HttpError(403,`Access denied. This route requires "${name}" not to apply.`)}};cache.set(name,negated);return negated}function loadParsedMiddleware(parsed){const negatedCache=parsed.negated?negatedMiddlewareCache??=new Map:undefined;const cached=middlewareCache?.get(parsed.name);if(cached!==undefined)return cached&&negatedCache?negateMiddleware(parsed.name,cached,negatedCache):cached;return loadMiddleware(parsed.name).then((handler)=>handler&&negatedCache?negateMiddleware(parsed.name,handler,negatedCache):handler)}export function clearMiddlewareCache(){corsHeaderApplierCache={};compressionApplierCache={};middlewareCache=undefined;negatedMiddlewareCache=undefined;resolvedMiddlewareEntryCache=undefined;resolvedCsrfOnlyMiddleware=undefined;parsedMiddlewareCache=undefined;middlewareAliasesPromise=null;middlewareRegistryPromise=null;actionRegistryPromise=null;actionSkipsCsrfCache.clear();routeHandlerKeyRegistry.clear();routeActionRegistry=undefined;clearCsrfModuleCache()}export function installMiddlewareHotReload(){if(process.env.APP_ENV==="production"||process.env.NODE_ENV==="production"){return()=>{}}let fsWatchers=[];(async()=>{try{const fs=await import("node:fs");const targets=[appPath("Middleware"),appPath("Middleware.ts")];for(const target of targets){try{if(!fs.existsSync(target))continue;const w=fs.watch(target,{recursive:true},()=>{log.debug("[middleware] hot-reload: clearing cache");clearMiddlewareCache()});fsWatchers.push(w)}catch{}}}catch{}})();return()=>{for(const w of fsWatchers){try{w.close()}catch{}}fsWatchers=[]}}export function clearRouteMiddlewareRegistry(){for(const registry of routeStateRegistries){const registeredKeys=clearedRouteKeysByRegistry.get(registry)??new Set;for(const routeKey of registry.keys())registeredKeys.add(routeKey);clearedRouteKeysByRegistry.set(registry,registeredKeys);for(const state of registry.values()){if(state.middleware)state.middleware.length=0}registry.clear()}routeStateRegistries.clear()}let routeApiResponseRegistry;let parsedMiddlewareCache;function parseMiddlewareEntry(middleware){const cache=parsedMiddlewareCache??=new Map;let parsed=cache.get(middleware);if(!parsed){parsed=parseMiddlewareEntryUncached(middleware).then((resolved)=>{cache.set(middleware,resolved);return resolved},(error)=>{cache.delete(middleware);throw error});cache.set(middleware,parsed)}return parsed}async function parseMiddlewareEntryUncached(middleware){const timingName=middleware.replace(/[^A-Za-z0-9_-]/g,"_").slice(0,32);const negated=middleware.startsWith("!");const bare=negated?middleware.slice(1):middleware;const aliases=await getMiddlewareAliases();if(Object.hasOwn(aliases,bare))return{name:bare,negated,timingName};const colonIndex=bare.indexOf(":");if(colonIndex===-1)return{name:bare,negated,timingName};return{name:bare.substring(0,colonIndex),negated,timingName,params:bare.substring(colonIndex+1)}}export async function findUnresolvableRouteMiddleware(){const usage=new Map;for(const registry of routeStateRegistries){for(const[routeKey,state]of registry){const entries=state.middleware;if(!entries)continue;for(const entry of entries){const pending=parseMiddlewareEntry(entry);const parsed=pending instanceof Promise?await pending:pending;const alias=parsed.negated?`!${parsed.name}`:parsed.name;const seen=usage.get(alias)??{parsed,routes:[]};seen.routes.push(routeKey);usage.set(alias,seen)}}}if(!usage.has("csrf"))usage.set("csrf",{parsed:{name:"csrf",negated:false,timingName:"csrf"},routes:["(auto-injected on POST/PUT/PATCH/DELETE)"]});const unresolvable=[];for(const[alias,{parsed,routes}]of usage){const handler=await loadParsedMiddleware(parsed);if(!handler||typeof handler.handle!=="function")unresolvable.push({alias,routes})}return unresolvable}export async function assertRouteMiddlewareResolvable(){const unresolvable=await findUnresolvableRouteMiddleware();if(unresolvable.length===0)return;const detail=unresolvable.map((u)=>`"${u.alias}" (used by ${u.routes.join(", ")})`).join("; ");throw new Error(`[Router] Unresolvable middleware alias(es): ${detail}. Check the alias map in app/Middleware.ts or add app/Middleware/<Class>.ts.`)}function applyRequestedResponseHeaders(req,headers){const requested=req._responseHeaders;if(!requested||typeof requested!=="object")return;for(const[name,value]of Object.entries(requested)){if(typeof value==="string")headers.set(name,value)}}function runAfterResponse(req,status,durationMs){const after=req._afterResponse;if(!Array.isArray(after))return;for(const callback of after){try{if(typeof callback==="function")callback({status,durationMs})}catch{}}}function elapsedSinceStart(req){const startNs=req._startNs;return startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null}function finishSynchronousResult(req,response,csrfHandledByOuter,routeSeedsCsrf){const frameworkMetadataApplied=typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number";if(response.status>=400||req._corsConfig||req._compress===true||req._startNs!=null||Array.isArray(req._afterResponse)||req._responseHeaders){return}if(frameworkMetadataApplied&&!routeSeedsCsrf)return response;let finalized=response;if(routeSeedsCsrf&&!csrfHandledByOuter&&req[CSRF_SEEDED_BY_HANDLE_REQUEST]!==true){const mod=loadCsrfModule();if(mod instanceof Promise)return;if(mod){finalized=mod.seedCsrfCookieIfMissing(req,finalized,req._csrfToken,frameworkMetadataApplied)}}if(!frameworkMetadataApplied){try{const requestId=req._requestId;if(requestId)finalized.headers.set("X-Request-ID",requestId);applySecurityHeaders(finalized.headers)}catch{return}}return finalized}function routeCapabilityFlags(routeKey,handler,csrfEnabled){const routeMethod=routeKey.slice(0,routeKey.indexOf(":")).toUpperCase();const action=isRouterAction(handler)?handler:undefined;const forcesJson=routeApiResponseRegistry?.has(routeKey)===true||action?.apiResponse===true;let flags=0;if(csrfEnabled&&(routeMethod==="POST"||routeMethod==="PUT"||routeMethod==="PATCH"||routeMethod==="DELETE"))flags|=ROUTE_ACCEPTS_CSRF;if(routeMethod!=="GET"&&routeMethod!=="HEAD")flags|=ROUTE_MAY_HAVE_BODY;if(csrfEnabled&&!forcesJson&&(routeMethod==="GET"||routeMethod==="HEAD"))flags|=ROUTE_RENDERS_CSRF;if(csrfEnabled&&(routeMethod==="GET"||routeMethod==="HEAD"||routeMethod==="OPTIONS"))flags|=ROUTE_SEEDS_CSRF;if(forcesJson)flags|=ROUTE_FORCES_JSON;if(action&&(action.skipCsrf===true||action.csrf===false))flags|=ROUTE_ACTION_SKIPS_CSRF;return flags}let routeRateLimitModule;function createMiddlewareHandler(router,routeStates,routeKey,handler,csrfEnabled=true){const routeState=routeStates.get(routeKey);const routeFlags=routeCapabilityFlags(routeKey,handler,csrfEnabled);const handlerKey=typeof handler==="string"?handler:undefined;const synchronousInlineHandler=typeof handler==="function"&&handler.constructor.name!=="AsyncFunction"?handler:undefined;const asynchronousInlineHandler=typeof handler==="function"&&handler.constructor.name==="AsyncFunction"?handler:undefined;const wrappedBase=typeof handler==="function"?undefined:wrapHandler(handler,true,routeKey);const handleAsyncInContext=async(req,preparedBaseResult,hasPreparedBaseResult=false)=>{if((routeFlags&ROUTE_MAY_HAVE_BODY)!==0&&routeState?.parseBody!==false){try{await parseRequestBody(req)}catch(err){const error=err instanceof Error?err:new Error(String(err));return createMiddlewareErrorResponse(error,req)}}const enhancedReq=req;const csrfHandledByOuter=enhancedReq[CSRF_SEEDED_BY_HANDLE_REQUEST]===true;if(!csrfHandledByOuter&&(routeFlags&ROUTE_RENDERS_CSRF)!==0&&requestMayRenderHtml(enhancedReq)){const renderTokenSeeding=seedCsrfTokenForRender(enhancedReq);if(renderTokenSeeding)await renderTokenSeeding}if(handlerKey&&(routeFlags&ROUTE_ACCEPTS_CSRF)!==0&&actionSkipsCsrfCache.get(handlerKey)===undefined){const pending=resolveStringHandler(handlerKey);if(pending instanceof Promise){try{await pending}catch{}}}if((routeFlags&ROUTE_FORCES_JSON)!==0){req._forceJson=true}if(!hasPreparedBaseResult&&synchronousInlineHandler&&(routeFlags&ROUTE_ACCEPTS_CSRF)===0&&!routeState?.middleware?.length&&!routeState?.rateLimit){try{preparedBaseResult=runWithRequestArguments(enhancedReq,invokeInlineHandler,enhancedReq,synchronousInlineHandler,undefined)}catch(error){preparedBaseResult=createHandlerErrorResponse(error,enhancedReq,routeKey,router)}hasPreparedBaseResult=true;if(preparedBaseResult instanceof Response){const finished=finishSynchronousResult(enhancedReq,preparedBaseResult,csrfHandledByOuter,(routeFlags&ROUTE_SEEDS_CSRF)!==0);if(finished)return finished}}const rl=routeState?.rateLimit;if(rl){try{const{rateLimit:enforceRateLimit}=routeRateLimitModule??=await import("./rate-limit");await enforceRateLimit(routeKey,rl.max).over(rl.windowSeconds)}catch(err){return createMiddlewareErrorResponse(err,req)}}const userMiddleware=routeState?.middleware??EMPTY_MIDDLEWARE_ENTRIES;let shouldInjectCsrf=false;if((routeFlags&ROUTE_ACCEPTS_CSRF)!==0){const alreadyHasCsrf=userMiddleware.some((m)=>m==="csrf"||m.startsWith("csrf:"));const routeCsrfMode=routeState?.csrfMode??CSRF_DEFAULT;const routeSkipped=routeCsrfMode===CSRF_SKIPPED;const routeRequired=routeCsrfMode===CSRF_REQUIRED;const actionSkipped=(routeFlags&ROUTE_ACTION_SKIPS_CSRF)!==0||(handlerKey?actionSkipsCsrfCache.get(handlerKey)===true:false);shouldInjectCsrf=!alreadyHasCsrf&&(routeRequired||!routeSkipped&&!actionSkipped)}const middlewareEntries=shouldInjectCsrf?userMiddleware.length===0?CSRF_ONLY_MIDDLEWARE:["csrf",...userMiddleware]:userMiddleware;let middlewareTimings=EMPTY_MIDDLEWARE_TIMINGS;if(middlewareEntries.length>0){if(isDebugLogging()){const schemeEnd=req.url.indexOf("://");const pathStart=schemeEnd===-1?0:req.url.indexOf("/",schemeEnd+3);const q=req.url.indexOf("?",pathStart<0?0:pathStart);const urlPath=pathStart<0?"/":req.url.slice(pathStart,q===-1?undefined:q);const routeMethod=routeKey.slice(0,routeKey.indexOf(":")).toUpperCase();log.debug(`[middleware] Executing chain: [${middlewareEntries.join(", ")}] for ${routeMethod} ${urlPath}`)}const cachedCsrfOnlyMiddleware=middlewareEntries===CSRF_ONLY_MIDDLEWARE?resolvedCsrfOnlyMiddleware:undefined;const resolved=cachedCsrfOnlyMiddleware??[];const resolvedCache=resolvedMiddlewareEntryCache??=new Map;const unresolvedEntries=cachedCsrfOnlyMiddleware?EMPTY_MIDDLEWARE_ENTRIES:middlewareEntries;for(const middlewareEntry of unresolvedEntries){let resolvedEntry=resolvedCache.get(middlewareEntry);if(!resolvedEntry){const pending=parseMiddlewareEntry(middlewareEntry);const parsed=pending instanceof Promise?await pending:pending;const loaded=loadParsedMiddleware(parsed);const middleware=loaded instanceof Promise?await loaded:loaded;if(middleware&&typeof middleware.handle==="function"){const rawPriority=middleware.priority;let priority=DEFAULT_MIDDLEWARE_PRIORITY;if(typeof rawPriority==="number"&&Number.isFinite(rawPriority)&&rawPriority>=0){priority=rawPriority}else if(rawPriority!==undefined){warnInvalidMiddlewarePriority(middlewareEntry,rawPriority)}resolvedEntry={name:middlewareEntry,timingName:parsed.timingName,handler:middleware,priority,parameterName:parsed.params?parsed.name:undefined,params:parsed.params};resolvedCache.set(middlewareEntry,resolvedEntry)}}if(!resolvedEntry){log.error(`[Router] Middleware '${middlewareEntry}' on ${routeKey} could not be resolved - failing closed`);const failClosedError=new Error(`Middleware '${middlewareEntry}' could not be resolved`);const failClosedResponse=await createErrorResponse(failClosedError,enhancedReq,{status:500});return await applyCorsIfConfigured(enhancedReq,failClosedResponse)}if(resolvedEntry.params&&resolvedEntry.parameterName){enhancedReq._middlewareParams=enhancedReq._middlewareParams||{};enhancedReq._middlewareParams[resolvedEntry.parameterName]=resolvedEntry.params}resolved.push(resolvedEntry)}if(middlewareEntries===CSRF_ONLY_MIDDLEWARE&&!cachedCsrfOnlyMiddleware&&resolved.length===1&&resolvedCache===resolvedMiddlewareEntryCache)resolvedCsrfOnlyMiddleware=resolved;if(resolved.length>1)resolved.sort((a,b)=>a.priority-b.priority);const collectsMiddlewareTimings=enhancedReq._startNs!=null;if(collectsMiddlewareTimings)middlewareTimings=[];let chainTimer;let chainBudget;let runningMiddleware="";try{for(const{name:middlewareName,timingName,handler:middleware}of resolved){const mwStart=collectsMiddlewareTimings?performance.now():0;runningMiddleware=middlewareName;try{const outcome=middleware.handle(enhancedReq);if(outcome&&typeof outcome.then==="function"){if(!chainBudget){chainBudget=new Promise((_,reject)=>{chainTimer=setTimeout(()=>reject(new Error(`Middleware '${runningMiddleware}' exceeded ${MIDDLEWARE_TIMEOUT_MS}ms`)),MIDDLEWARE_TIMEOUT_MS)});chainBudget.catch(()=>{})}await Promise.race([outcome,chainBudget])}if(collectsMiddlewareTimings){const elapsedMs=performance.now()-mwStart;middlewareTimings.push({name:timingName,ms:elapsedMs})}}catch(error){if(collectsMiddlewareTimings){const elapsedMs=performance.now()-mwStart;middlewareTimings.push({name:timingName,ms:elapsedMs})}log.debug(`[middleware] Blocked by: ${middlewareName}`);if(error instanceof Response){try{applyRequestedResponseHeaders(enhancedReq,error.headers);const reqId=enhancedReq._requestId;const startNs=enhancedReq._startNs;const total=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null;const parts=total!=null?[`total;dur=${total.toFixed(1)}`]:[];for(const t of middlewareTimings){parts.push(`mw_${t.name};dur=${t.ms.toFixed(1)}`)}if(parts.length>0)error.headers.set("Server-Timing",parts.join(", "));if(reqId)error.headers.set("X-Request-ID",reqId)}catch{}runAfterResponse(enhancedReq,error.status,elapsedSinceStart(enhancedReq)??0);return await applyCorsIfConfigured(enhancedReq,error)}const err=error instanceof Error?error:new Error(String(error));const errorResponse="statusCode"in err||"status"in err?await createMiddlewareErrorResponse(err,enhancedReq):await(()=>{log.error(`[Router] Middleware '${middlewareName}' threw an unexpected error:`,err);return createErrorResponse(err,enhancedReq,{status:500})})();try{applyRequestedResponseHeaders(enhancedReq,errorResponse.headers);const reqId=enhancedReq._requestId;const startNs=enhancedReq._startNs;const total=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null;const parts=total!=null?[`total;dur=${total.toFixed(1)}`]:[];for(const t of middlewareTimings){parts.push(`mw_${t.name};dur=${t.ms.toFixed(1)}`)}if(parts.length>0)errorResponse.headers.set("Server-Timing",parts.join(", "));if(reqId)errorResponse.headers.set("X-Request-ID",reqId)}catch{}runAfterResponse(enhancedReq,errorResponse.status,elapsedSinceStart(enhancedReq)??0);return await applyCorsIfConfigured(enhancedReq,errorResponse)}}}finally{if(chainTimer)clearTimeout(chainTimer)}}const formatsResolvedInlineResult=asynchronousInlineHandler!==undefined&&!hasPreparedBaseResult;let response;try{const baseResult=hasPreparedBaseResult?preparedBaseResult:asynchronousInlineHandler?asynchronousInlineHandler(enhancedReq):synchronousInlineHandler?invokeInlineHandler(enhancedReq,synchronousInlineHandler,undefined):wrappedBase(enhancedReq);const resolvedResult=baseResult instanceof Response?baseResult:await baseResult;response=formatsResolvedInlineResult?formatResult(resolvedResult,enhancedReq):resolvedResult}catch(error){response=await createHandlerErrorResponse(error,enhancedReq,handlerKey||routeKey,router)}if(response){if((routeFlags&ROUTE_SEEDS_CSRF)!==0&&!csrfHandledByOuter&&enhancedReq[CSRF_SEEDED_BY_HANDLE_REQUEST]!==true){try{const mod=loadCsrfModule();const csrf=mod instanceof Promise?await mod:mod;if(csrf){response=csrf.seedCsrfCookieIfMissing(enhancedReq,response,enhancedReq._csrfToken,typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number")}}catch(err){log.warn("[router] CSRF cookie seeding failed",{error:err})}}}if(response&&enhancedReq._corsConfig){const corsResponse=applyCorsIfConfigured(enhancedReq,response);response=corsResponse instanceof Response?corsResponse:await corsResponse}const reqId=enhancedReq._requestId;const startNs=enhancedReq._startNs;const durMs=startNs!=null?Number(process.hrtime.bigint()-startNs)/1e6:null;const after=enhancedReq._afterResponse;const requested=enhancedReq._responseHeaders;const frameworkMetadataApplied=response&&typeof response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]==="number";const needsResponseMetadata=response&&(response.status>=400||Array.isArray(after)||requested&&typeof requested==="object"||durMs!=null||!frameworkMetadataApplied);if(needsResponseMetadata&&typeof response.headers?.set==="function"){const setHeaders=(h)=>{runAfterResponse(enhancedReq,response.status,durMs??0);applyRequestedResponseHeaders(enhancedReq,h);if(reqId&&!frameworkMetadataApplied)h.set("X-Request-ID",reqId);if(durMs!=null){let timing=`total;dur=${durMs.toFixed(1)}`;for(const t of middlewareTimings){timing+=`, mw_${t.name};dur=${t.ms.toFixed(1)}`}h.set("Server-Timing",timing)}if(!frameworkMetadataApplied)applySecurityHeaders(h)};const isErrorJson=response.status>=400&&(response.headers.get("content-type")||"").includes("json");if(isErrorJson&&reqId){try{const text=await response.clone().text();const parsed=JSON.parse(text);if(parsed&&typeof parsed==="object"&&!Array.isArray(parsed)&&parsed.jsonrpc!=="2.0"){const newHeaders=new Headers(response.headers);setHeaders(newHeaders);return new Response(JSON.stringify({...parsed,request_id:reqId}),{status:response.status,statusText:response.statusText,headers:newHeaders})}}catch{}}try{setHeaders(response.headers)}catch{try{const cloned=response.clone();const newHeaders=new Headers(response.headers);setHeaders(newHeaders);return new Response(cloned.body,{status:response.status,statusText:response.statusText,headers:newHeaders})}catch{}}}if(enhancedReq._compress===true&&response){try{const cache=compressionApplierCache;const applyCompression=cache.apply??=(await import(resolveDefaultsPath("app/Middleware/Compress.ts"))).applyCompression;const bodySizeUpperBound=response[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND];return await applyCompression(enhancedReq,response,typeof bodySizeUpperBound==="number"?bodySizeUpperBound:undefined)}catch(err){log.warn(`[router] Compression failed; sending uncompressed response: ${err instanceof Error?err.message:String(err)}`)}}return response};if(!synchronousInlineHandler||(routeFlags&ROUTE_MAY_HAVE_BODY)!==0)return rememberStacksRouteHandler(bindAsyncRouteHandler(handleAsyncInContext));const handleSynchronous=(req)=>{if(routeState?.middleware?.length||routeState?.rateLimit)return runWithRequestArgument(req,handleAsyncInContext,req);const csrfHandledByOuter=req[CSRF_SEEDED_BY_HANDLE_REQUEST]===true;if((routeFlags&ROUTE_RENDERS_CSRF)!==0&&!csrfHandledByOuter&&requestMayRenderHtml(req)){const renderTokenSeeding=seedCsrfTokenForRender(req);if(renderTokenSeeding)return renderTokenSeeding.then(()=>runWithRequestArgument(req,handleAsyncInContext,req))}if((routeFlags&ROUTE_FORCES_JSON)!==0)req._forceJson=true;let preparedBaseResult;try{preparedBaseResult=runWithRequestArguments(req,invokeInlineHandler,req,synchronousInlineHandler,undefined)}catch(error){preparedBaseResult=createHandlerErrorResponse(error,req,routeKey,router)}if(preparedBaseResult instanceof Response){const finished=finishSynchronousResult(req,preparedBaseResult,csrfHandledByOuter,(routeFlags&ROUTE_SEEDS_CSRF)!==0);if(finished)return finished}return runWithRequestArguments(req,handleAsyncInContext,req,preparedBaseResult,true)};return rememberStacksRouteHandler(handleSynchronous)}function createInertRoute(){const inert={parseBody:()=>inert,middleware:()=>inert,name:()=>inert,skipCsrf:()=>inert,requireCsrf:()=>inert,rateLimit:()=>inert};return inert}function createChainableRoute(routeStates,routeKey,shadowed=false,siblingRouteKeys=[]){if(shadowed)return createInertRoute();const routePath=routeKey.includes(":")?routeKey.substring(routeKey.indexOf(":")+1):routeKey;const states=[routeKey,...siblingRouteKeys].flatMap((key)=>{const state=routeStates.get(key);return state?[state]:[]});const chain={parseBody(enabled){if(typeof enabled!=="boolean")throw new TypeError("parseBody() requires a boolean");for(const state of states)state.parseBody=enabled;return chain},middleware(name){for(const entry of Array.isArray(name)?name:[name]){if(typeof entry!=="string"){throw new TypeError(`[Router] middleware() on ${routeKey} was given a ${typeof entry}; it takes an alias or an array of aliases`)}for(const state of states)(state.middleware??=[]).push(entry)}return chain},name(routeName){const registry=namedRouteRegistry??=new Map;registry.set(routeName,compileNamedRoute(routePath));return chain},skipCsrf(){for(const state of states)state.csrfMode=CSRF_SKIPPED;return chain},requireCsrf(){for(const state of states)state.csrfMode=CSRF_REQUIRED;return chain},rateLimit(max,window){if(!Number.isFinite(max)||max<=0){throw new Error(`[Router] .rateLimit(): max must be a positive number, got ${String(max)}`)}const windowSeconds=rateLimitWindowToSeconds(window);for(const state of states)state.rateLimit={max:Math.floor(max),windowSeconds};return chain}};return chain}async function fileExists(path){try{const file=Bun.file(path);return await file.exists()}catch{return false}}function assertSafeHandlerPath(handlerPath){if(typeof handlerPath!=="string"||handlerPath.length===0){throw new Error(`[Router] Refusing to resolve handler '${String(handlerPath)}': empty or non-string`)}if(handlerPath.includes("\x00")){throw new Error(`[Router] Refusing to resolve handler with null byte`)}if(handlerPath.startsWith("/")||/^[A-Za-z]:[\\/]/.test(handlerPath)){throw new Error(`[Router] Refusing to resolve absolute handler path '${handlerPath}'`)}const segments=handlerPath.split(/[/\\]/);if(segments.some((s)=>s==="..")){throw new Error(`[Router] Refusing to resolve handler path '${handlerPath}' (contains '..' segment)`)}}let _moduleImportCache;function cachedImport(fullPath){const cache=_moduleImportCache??=new Map;let p=cache.get(fullPath);if(!p){p=import(fullPath);cache.set(fullPath,p)}return p}let _resolvedHandlerCache;function resolveStringHandler(handlerPath){const cache=_resolvedHandlerCache??=new Map;let resolved=cache.get(handlerPath);if(!resolved){resolved=resolveStringHandlerUncached(handlerPath).then((handler)=>{cache.set(handlerPath,handler);return handler},(error)=>{cache.delete(handlerPath);throw error});cache.set(handlerPath,resolved)}return resolved}function validationFailureResponse(errors){return response.validationError(errors)}export function precognitionRequest(req,knownHeader){const header=knownHeader===undefined?req.headers?.get?.("Precognition"):knownHeader;const viaHeader=typeof header==="string"&&header.toLowerCase()==="true";let viaQuery=false;try{if(!viaHeader&&req.url.includes("?"))viaQuery=new URL(req.url).searchParams.get("_validate")==="1"}catch{viaQuery=false}if(!viaHeader&&!viaQuery)return null;const only=(req.headers?.get?.("Precognition-Validate-Only")??"").split(",").map((field)=>field.trim()).filter(Boolean);return{only}}export function precognitionSuccess(){return new Response(null,{status:204,headers:{Precognition:"true","Precognition-Success":"true",Vary:"Precognition, Precognition-Validate-Only"}})}let actionRegistryPromise=null;async function getActionRegistry(){if(actionRegistryPromise)return actionRegistryPromise;actionRegistryPromise=(async()=>{const dir=storagePath("framework/auto-imports");const registryPath=`${dir}/actions.ts`;if(!existsSync(registryPath))return null;const module=await import(registryPath);if(!module.actions)throw new Error(`Invalid actions registry: ${registryPath}`);return module.actions})();return actionRegistryPromise}function isInsideAppActions(file){const local=relative(appPath("Actions"),file);return Boolean(local)&&local!==".."&&!local.startsWith(`..${sep}`)&&!isAbsolute(local)}const staleRegistryWarned=new Set;function warnStaleActionRegistry(name,registered,appFile){if(staleRegistryWarned.has(name))return;staleRegistryWarned.add(name);log.warn(`[router] The action registry maps ${name} to ${registered}, but the app has ${appFile}; using the app's. The registry is stale: run \`./buddy generate:auto-imports\` and commit storage/framework/auto-imports if you track it.`)}function appActionModulePath(sourcePath){if(!sourcePath.endsWith(".ts")||lstatSync(sourcePath,{throwIfNoEntry:false}))return sourcePath;const local=relative(appPath("Actions"),sourcePath);if(!local||local===".."||local.startsWith(`..${sep}`)||isAbsolute(local))return sourcePath;const emitted=`${sourcePath.slice(0,-3)}.js`;return statSync(emitted,{throwIfNoEntry:false})?.isFile()?emitted:sourcePath}const providedActions=new Map;export function provideActions(loaders){for(const[name,load]of Object.entries(loaders))providedActions.set(name.endsWith(".ts")?name.slice(0,-3):name,load)}async function resolveStringHandlerUncached(handlerPath){assertSafeHandlerPath(handlerPath);let modulePath=handlerPath;modulePath=modulePath.endsWith(".ts")?modulePath.slice(0,-3):modulePath;const provided=providedActions.get(modulePath);if(provided){const action=(await provided()).default;if(!action||typeof action.handle!=="function")throw new Error(`Action '${handlerPath}' has no default export with a handle() method`);return wrapAction(action,handlerPath)}if(modulePath.includes("Controller")){const[controllerPath,methodName="index"]=modulePath.split("@");const userPath=appPath(`${controllerPath}.ts`);const defaultPath=resolveDefaultsPath(`app/${controllerPath}.ts`);const fullPath=await fileExists(userPath)?userPath:defaultPath;try{const controller=await cachedImport(fullPath);if(!controller.default||typeof controller.default!=="function"){throw new Error(`Controller ${controllerPath} does not export a default class`)}const instance=new controller.default;if(typeof instance[methodName]!=="function"){throw new Error(`Method ${methodName} not found in controller ${controllerPath}`)}return async(req)=>{const result=await instance[methodName](req);return formatResult(result,req)}}catch(error){log.error(`[Router] Failed to load controller '${fullPath}':`,error);throw error}}let fullPath;if(modulePath.includes("storage/framework/orm")){fullPath=modulePath}else if(modulePath.includes("OrmAction")){fullPath=storagePath(`framework/actions/src/${modulePath}.ts`)}else if(modulePath.includes("Actions")){const specifier=(await getActionRegistry())?.[modulePath];const registered=specifier?resolveModulePath(specifier,storagePath("framework/auto-imports")):undefined;const userPath=appActionModulePath(projectPath(`app/${modulePath}.ts`));if(registered&&!isInsideAppActions(registered)&&await fileExists(userPath)){warnStaleActionRegistry(modulePath,registered,userPath);fullPath=userPath}else if(registered){fullPath=appActionModulePath(registered)}else{const defaultPath=resolveDefaultsPath(`app/${modulePath}.ts`);fullPath=await fileExists(userPath)?userPath:defaultPath}}else{const userPath=appPath(`${modulePath}.ts`);const defaultPath=resolveDefaultsPath(`app/${modulePath}.ts`);fullPath=await fileExists(userPath)?userPath:defaultPath}try{const actionModule=await cachedImport(fullPath);const action=actionModule.default;if(!action){throw new Error(`Action '${handlerPath}' has no default export`)}if(typeof action.handle!=="function"){log.error(`[Router] Action '${handlerPath}' structure:`,Object.keys(action));throw new Error(`Action '${handlerPath}' has no handle() method. Got: ${typeof action.handle}`)}return wrapAction(action,handlerPath)}catch(importError){log.error(`[Router] Failed to import action '${fullPath}':`,importError);throw importError}}export function isRouterAction(handler){return typeof handler==="object"&&handler!==null&&typeof handler.handle==="function"}export function wrapAction(action,handlerKey){const actionSkipsCsrf=action.skipCsrf===true||action.csrf===false;actionSkipsCsrfCache.set(handlerKey,actionSkipsCsrf);const actionForcesJson=action.apiResponse===true;const requestValidationRules=action.validations??modelValidationRules(action.modelDefinition??action.model);const actionValidationEntries=action.validations?compileActionValidationEntries(action.validations):undefined;const routeSeparator=handlerKey.indexOf(":");const actionMayHaveRouteParams=routeSeparator===-1||handlerKey.indexOf("{",routeSeparator+1)!==-1;const prepareRequest=(req)=>{const precognitionHeader=req.headers.get("Precognition");const requestHasQuery=req.url.includes("?");const precognition=precognitionHeader===null&&!requestHasQuery?null:precognitionRequest(req,precognitionHeader);if(precognition){if(!action.validations)return precognitionSuccess();const rules=precognition.only.length>0?Object.fromEntries(Object.entries(action.validations).filter(([field])=>precognition.only.includes(field))):action.validations;const precognitionResult=validateActionInputSync(req,rules,rules===action.validations?actionValidationEntries:undefined,actionMayHaveRouteParams,true,requestHasQuery);return precognitionResult.valid?precognitionSuccess():validationFailureResponse(precognitionResult.errors)}if(action.validations){const validationResult=validateActionInputSync(req,action.validations,actionValidationEntries,actionMayHaveRouteParams,true,requestHasQuery);if(!validationResult.valid)return validationFailureResponse(validationResult.errors)}};const rethrowActionError=(handleError)=>{report(handleError,{label:`[Router] action.handle() for '${handlerKey}'`});throw handleError};if(typeof action.authorize!=="function"&&typeof action.before!=="function"){return(req)=>{if(actionSkipsCsrf)req._skipCsrf=true;if(actionForcesJson)req._forceJson=true;req._requestValidationRules=requestValidationRules;try{const earlyResponse=prepareRequest(req);if(earlyResponse)return earlyResponse;const result=action.handle(req);return result instanceof Promise?result.then((value)=>{try{return formatResult(value,req)}catch(error){return rethrowActionError(error)}},rethrowActionError):formatResult(result,req)}catch(handleError){return rethrowActionError(handleError)}}}return async(req)=>{if(actionSkipsCsrf){req._skipCsrf=true}if(actionForcesJson){req._forceJson=true}req._requestValidationRules=requestValidationRules;try{const earlyResponse=prepareRequest(req);if(earlyResponse)return earlyResponse;if(typeof action.authorize==="function"){const pendingAuth=action.authorize(req);const auth=pendingAuth!==null&&(typeof pendingAuth==="object"||typeof pendingAuth==="function")?await pendingAuth:pendingAuth;if(auth instanceof Response)return auth;if(auth===false){return Response.json({error:"Forbidden"},{status:403})}}if(typeof action.before==="function"){const pendingBefore=action.before(req);const pre=pendingBefore!==null&&(typeof pendingBefore==="object"||typeof pendingBefore==="function")?await pendingBefore:pendingBefore;if(pre instanceof Response)return pre}const pendingResult=action.handle(req);const result=pendingResult instanceof Promise?await pendingResult:pendingResult;return formatResult(result,req)}catch(handleError){return rethrowActionError(handleError)}}}const EMPTY_VALIDATION_ERRORS=Object.freeze({});const VALID_ACTION_VALIDATION_RESULT=Object.freeze({valid:true,errors:EMPTY_VALIDATION_ERRORS});function compileActionValidationEntries(validations){return Object.entries(validations).map(([field,validation])=>[field,validation,undefined])}function createValidationFieldLabel(field){const label=field.replace(/[-_]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").replace(/^./,(c)=>c.toUpperCase());const lowerField=field.toLowerCase();return{label,decorate:(message)=>{if(message.toLowerCase().startsWith(lowerField)||message.includes(label))return message;if(message.startsWith("This field "))return`${label} ${message.slice("This field ".length)}`;return`${label} ${/^[A-Z][a-z]/.test(message)?message[0].toLowerCase()+message.slice(1):message}`}}}function validateActionInputSync(req,validations,compiledEntries,mayHaveRouteParams=true,reuseSuccessResult=false,requestHasQuery=req.url.includes("?")){let errors;const validated=newInput();let valid=true;const entries=compiledEntries??Object.entries(validations);const input=getRequestInput(req,entries,mayHaveRouteParams,requestHasQuery);for(let entryIndex=0;entryIndex<entries.length;entryIndex++){const entry=entries[entryIndex];const field=entry[0];const validation=entry[1];const value=input[field];let rule=validation.rule;let result;try{if(rule.__conditionals?.length)rule=require("@stacksjs/validation/conditional").applyConditionals(rule,input);result=validation.message&&typeof validation.message==="object"?validationMessages().validateRule(rule,value):rule.validate(value)}catch{result={valid:false,errors:[{message:`${field} validation failed`}]}}if(result&&!result.valid){valid=false;const fieldErrors=[];const{label,decorate}=entry[2]??=createValidationFieldLabel(field);const reported=Array.isArray(result.errors)?result.errors:Object.values(result.errors??{}).flat();if(reported.length>0){if(validation.message&&typeof validation.message==="object")fieldErrors.push(...validationMessages().fieldErrorMessages(rule,value,reported,validation.message,field,decorate));else if(validation.message)fieldErrors.push(validation.message);else reported.forEach((err)=>fieldErrors.push(decorate(err.message)))}else{fieldErrors.push(validation.message?typeof validation.message==="string"?validation.message:`${label} is invalid`:`${label} is invalid`)}(errors??=Object.create(null))[field]=fieldErrors}else if(value!==undefined){validated[field]=result&&Object.hasOwn(result,"value")?result.value:value}}if(valid){req._validatedInput=validated}if(valid&&reuseSuccessResult)return VALID_ACTION_VALIDATION_RESULT;return{valid,errors:errors??{}}}export async function validateActionInput(req,validations){return validateActionInputSync(req,validations)}function modelValidationRules(model){if(!model?.attributes||typeof model.attributes!=="object")return;const rules={};for(const[field,attribute]of Object.entries(model.attributes)){const validation=attribute?.validation;if(validation?.rule)rules[field]=validation}return Object.keys(rules).length>0?rules:undefined}function newInput(){return Object.create(null)}function assignInput(target,source){for(const key of Object.keys(source))target[key]=source[key];return target}function getRequestInput(req,validationEntries,mayHaveRouteParams=true,requestHasQuery=req.url.includes("?")){let input;let mayNeedCoercion=false;if(requestHasQuery){const q=req.query;if(q){for(const key in q){(input??=newInput())[key]=q[key];mayNeedCoercion=true}}else{const url=new URL(req.url);url.searchParams.forEach((value,key)=>{(input??=newInput())[key]=value;mayNeedCoercion=true})}}if(req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody)){input=assignInput(input??newInput(),req.jsonBody)}else if(req.formBody&&typeof req.formBody==="object"){input=assignInput(input??newInput(),req.formBody);mayNeedCoercion=true}let hasRouteParams=false;if(mayHaveRouteParams&&req.params){for(const key in req.params){if(!Object.hasOwn(req.params,key))continue;(input??=newInput())[key]=req.params[key];hasRouteParams=true;mayNeedCoercion=true}}if(!requestHasQuery&&!mayHaveRouteParams&&req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody)&&!req.formBody&&!req.files){req._allInputCache=input}if(req.files&&typeof req.allFiles==="function"){try{const files=req.allFiles();for(const key of Object.keys(files??{})){const values=input??=newInput();if(!(key in values))values[key]=files[key]}}catch{}}if(!validationEntries)return input??{};input??={};let coerced=false;if(mayNeedCoercion){for(const[field,validation]of validationEntries){const value=input[field];if(typeof value!=="string")continue;const validatorName=validation.rule?.name;if(validatorName==="number"){const n=Number(value);if(Number.isFinite(n)){input[field]=n;coerced=true}}else if(validatorName==="boolean"){if(value==="true"||value==="1"){input[field]=true;coerced=true}else if(value==="false"||value==="0"){input[field]=false;coerced=true}}}}if(!coerced&&!req.formBody&&!req.files&&!hasRouteParams){req._allInputCache=input}return input}function formatResult(result,req){if(result instanceof Response){return result}if(result instanceof ReadableStream){return new Response(result,{headers:{"Content-Type":"application/octet-stream"}})}if(result!==null&&typeof result==="object"){const linkHeader="data"in result?buildPaginatorLinkHeader(result):null;return formatJsonResult(result,req,linkHeader)}const forceJson=req._forceJson===true;const apiShaped=forceJson||isApiRequest(req);if(result===null||result===undefined){return apiShaped?new Response(null,{status:204}):new Response("",{status:200})}if(apiShaped){if(typeof result==="string"||typeof result==="number"||typeof result==="boolean")return formatJsonResult(result,req);return serializedResponse(JSON.stringify(result)??"","application/json;charset=utf-8")}return serializedResponse(String(result),"text/plain; charset=utf-8")}function serializedResponse(body,contentType){return new Response(body,{headers:{"Content-Type":contentType,"Content-Length":String(Buffer.byteLength(body))}})}function formatJsonResult(result,req,linkHeader){const canPreapplyMetadata=!req._responseHeaders;const body=JSON.stringify(result)??"";const requestMarkers=req;const directNativeRequest=typeof requestMarkers[CSRF_SECURE_TRANSPORT]==="boolean"||requestMarkers[NATIVE_DIRECT_ROUTE_REQUEST]===true;const bodyLength=canPreapplyMetadata&&directNativeRequest?undefined:Buffer.byteLength(body);const nativeColdRequest=requestMarkers[CSRF_SEEDED_BY_HANDLE_REQUEST]!==true&&typeof requestMarkers[CSRF_SECURE_TRANSPORT]==="boolean";const csrf=nativeColdRequest?loadCsrfModule():null;const csrfCookie=canPreapplyMetadata&&csrf&&!(csrf instanceof Promise)&&typeof csrf.createCsrfCookie==="function"?csrf.createCsrfCookie(req,req._csrfToken):undefined;const response=canPreapplyMetadata?secureSerializedJsonResponse(body,bodyLength,req._requestId,csrfCookie):new Response(body,{headers:createJsonSecurityHeaders()});if(!canPreapplyMetadata)response.headers.set("Content-Length",String(bodyLength));if(linkHeader)response.headers.set("Link",linkHeader);if(canPreapplyMetadata){const frameworkResponse=response;frameworkResponse[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND]=bodyLength??(body.length*3>=1024&&body.length<1024?Buffer.byteLength(body):body.length*3)}if(csrfCookie)requestMarkers[CSRF_SEEDED_BY_HANDLE_REQUEST]=true;return response}function buildPaginatorLinkHeader(value){if(!isPaginator(value)&&!isSimplePaginator(value)&&!isCursorPaginator(value))return null;const v=value;const parts=[];if(v.prev_page_url)parts.push(`<${v.prev_page_url}>; rel="prev"`);if(v.next_page_url)parts.push(`<${v.next_page_url}>; rel="next"`);if(v.first_page_url)parts.push(`<${v.first_page_url}>; rel="first"`);if(v.last_page_url)parts.push(`<${v.last_page_url}>; rel="last"`);return parts.length>0?parts.join(", "):null}function iterableToStream(source){const encoder=new TextEncoder;let iterator;return new ReadableStream({async pull(controller){iterator??=source[Symbol.asyncIterator]();try{const{value,done}=await iterator.next();if(done)controller.close();else controller.enqueue(typeof value==="string"?encoder.encode(value):value)}catch(err){controller.error(err)}},async cancel(reason){await iterator?.return?.(reason)}},{highWaterMark:1})}export function stream(source,options={}){const baseHeaders={};if(options.type==="sse"){baseHeaders["Content-Type"]="text/event-stream; charset=utf-8";baseHeaders["Cache-Control"]="no-cache";baseHeaders["Connection"]="keep-alive"}else if(options.type==="ndjson"){baseHeaders["Content-Type"]="application/x-ndjson; charset=utf-8"}else{baseHeaders["Content-Type"]=options.contentType??"application/octet-stream"}const body=source instanceof ReadableStream?source:iterableToStream(source);const merged=new Headers(baseHeaders);if(options.headers){const extra=new Headers(options.headers);extra.forEach((value,key)=>merged.set(key,value))}return new Response(body,{status:options.status??200,headers:merged})}function getAllInputFor(req){const cached=req._allInputCache;if(cached)return cached;const input=newInput();const query=req.query;if(query){for(const key in query)input[key]=query[key]}if(req.jsonBody&&typeof req.jsonBody==="object"&&!Array.isArray(req.jsonBody))assignInput(input,req.jsonBody);if(req.formBody&&typeof req.formBody==="object")assignInput(input,req.formBody);if(req.params&&typeof req.params==="object")assignInput(input,req.params);req._allInputCache=input;return input}function flashInputFor(req,keys){const input=getAllInputFor(req);req._oldInput=keys?Object.fromEntries(keys.filter((key)=>(key in input)).map((key)=>[key,input[key]])):{...input}}const nativeRequestText=Request.prototype.text;const nativeRequestJson=Request.prototype.json;const nativeRequestBytes=Request.prototype.bytes;const nativeRequestArrayBuffer=Request.prototype.arrayBuffer;const nativeRequestBlob=Request.prototype.blob;const nativeRequestClone=Request.prototype.clone;let requestBodyEncoder;let requestValidationModule;let validationMessagesModule;function validationMessages(){return validationMessagesModule??=require("@stacksjs/validation/messages")}let UploadedFileConstructor;let requestGateModule;function createUploadedFile(file){UploadedFileConstructor??=require("@stacksjs/storage/uploaded-file").UploadedFile;return new UploadedFileConstructor(file)}const REQUEST_METHODS={text(){return this._rawBody===undefined?nativeRequestText.call(this):Promise.resolve(this._rawBody)},json(){if(this._rawBody===undefined)return nativeRequestJson.call(this);try{return Promise.resolve(this._rawBody.length===0?null:JSON.parse(this._rawBody))}catch(error){return Promise.reject(error)}},bytes(){return this._rawBody===undefined?nativeRequestBytes.call(this):Promise.resolve((requestBodyEncoder??=new TextEncoder).encode(this._rawBody))},arrayBuffer(){if(this._rawBody===undefined)return nativeRequestArrayBuffer.call(this);const bytes=(requestBodyEncoder??=new TextEncoder).encode(this._rawBody);return Promise.resolve(bytes.buffer)},blob(){return this._rawBody===undefined?nativeRequestBlob.call(this):Promise.resolve(new Blob([this._rawBody],{type:this._rawBodyContentType}))},clone(){if(this._rawBody===undefined)return nativeRequestClone.call(this);return new Request(this.url,{method:this.method,headers:this.headers,body:this._rawBody})},get(key,defaultValue){const input=getAllInputFor(this);const value=input[key];return value!==undefined?value:defaultValue},input(key,defaultValue){const input=getAllInputFor(this);const value=input[key];return value!==undefined?value:defaultValue},all(){return getAllInputFor(this)},only(keys){const input=getAllInputFor(this);const result={};for(const key of keys){if(key in input)result[key]=input[key]}return result},except(keys){const input=getAllInputFor(this);const result={...input};for(const key of keys)delete result[key];return result},has(key){const input=getAllInputFor(this);if(Array.isArray(key))return key.every((k)=>(k in input)&&input[k]!==undefined);return key in input&&input[key]!==undefined},hasAny(keys){const input=getAllInputFor(this);return keys.some((k)=>(k in input)&&input[k]!==undefined)},filled(key){const input=getAllInputFor(this);const isFilled=(k)=>{const value=input[k];return value!==undefined&&value!==null&&value!==""&&!(Array.isArray(value)&&value.length===0)};if(Array.isArray(key))return key.every(isFilled);return isFilled(key)},missing(key){const input=getAllInputFor(this);if(Array.isArray(key))return key.every((k)=>!(k in input)||input[k]===undefined);return!(key in input)||input[key]===undefined},merge(data){Object.assign(getAllInputFor(this),data)},keys(){return Object.keys(getAllInputFor(this))},string(key,defaultValue=""){const input=getAllInputFor(this);const value=input[key];return value!==undefined&&value!==null?String(value):defaultValue},integer(key,defaultValue=0){const input=getAllInputFor(this);const value=input[key];if(value===undefined||value===null||value==="")return defaultValue;if(typeof value==="number")return Number.isFinite(value)?Math.trunc(value):defaultValue;const str=String(value).trim();if(!/^-?\d+$/.test(str))return defaultValue;const parsed=Number.parseInt(str,10);return Number.isFinite(parsed)?parsed:defaultValue},float(key,defaultValue=0){const input=getAllInputFor(this);const value=input[key];if(value===undefined||value===null||value==="")return defaultValue;if(typeof value==="number")return Number.isFinite(value)?value:defaultValue;const str=String(value).trim();if(!/^-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(str))return defaultValue;const parsed=Number.parseFloat(str);return Number.isFinite(parsed)?parsed:defaultValue},boolean(key,defaultValue=false){const input=getAllInputFor(this);const value=input[key];if(value===undefined||value===null)return defaultValue;if(typeof value==="boolean")return value;if(value==="true"||value==="1"||value===1)return true;if(value==="false"||value==="0"||value===0)return false;return defaultValue},array(key){const input=getAllInputFor(this);const value=input[key];if(Array.isArray(value))return value;return value!==undefined&&value!==null?[value]:[]},date(key){const value=getAllInputFor(this)[key];if(value===undefined||value===null||value==="")return null;const parsed=new Date(value);return Number.isNaN(parsed.getTime())?null:parsed},enum(key,enumType){const value=getAllInputFor(this)[key];if(value===undefined||value===null)return null;if(Object.values(enumType).includes(value))return value;const enumKey=String(value);return enumKey in enumType?enumType[enumKey]:null},collect(key){const{collect}=require("@stacksjs/collections");const value=getAllInputFor(this)[key];if(Array.isArray(value))return collect(value);return collect(value===undefined||value===null?[]:[value])},whenHas(key,callback,defaultCallback){const input=getAllInputFor(this);if(key in input&&input[key]!==undefined)callback(input[key]);else defaultCallback?.()},whenFilled(key,callback,defaultCallback){const input=getAllInputFor(this);const value=input[key];const filled=value!==undefined&&value!==null&&value!==""&&!(Array.isArray(value)&&value.length===0);if(filled)callback(value);else defaultCallback?.()},isValue(key,value){return getAllInputFor(this)[key]===value},async validate(rules,messages={}){const selectedRules=rules??this._requestValidationRules;if(!selectedRules||Object.keys(selectedRules).length===0){const input=getAllInputFor(this);this._validatedInput=input;return input}const entries=Object.entries(selectedRules);let normalized=selectedRules;for(let index=0;index<entries.length;index++){const[field,definition]=entries[index];if(typeof definition==="string"){throw new TypeError(`String validation rules are not supported for "${field}". Use schema validators.`)}if(definition&&typeof definition==="object"&&"rule"in definition){const message=messages[field];if(message){if(normalized===selectedRules){normalized={};for(let previousIndex=0;previousIndex<index;previousIndex++){const[previousField,previousDefinition]=entries[previousIndex];normalized[previousField]=previousDefinition}}normalized[field]={...definition,message};continue}}if(normalized!==selectedRules)normalized[field]=definition}const{validate}=requestValidationModule??=await import("@stacksjs/validation/request-validator");const validated=await validate(this,normalized);this._validatedInput=validated;return validated},getValidated(){return this._validatedInput??{}},safe(){const data=this._validatedInput??{};return{all:()=>({...data}),get:(key,defaultValue)=>(key in data)?data[key]:defaultValue,only:(keys)=>Object.fromEntries(keys.filter((key)=>(key in data)).map((key)=>[key,data[key]])),except:(keys)=>Object.fromEntries(Object.entries(data).filter(([key])=>!keys.includes(key)))}},old(key,defaultValue){const oldInput=this._oldInput;return oldInput?.[key]??defaultValue},flashInput(keys){flashInputFor(this,keys)},flashInputOnly(keys){flashInputFor(this,keys)},flashInputExcept(keys){const input=getAllInputFor(this);this._oldInput=Object.fromEntries(Object.entries(input).filter(([key])=>!keys.includes(key)))},file(key){const files=this.files||{};const file=files[key];if(!file)return null;const rawFile=Array.isArray(file)?file[0]:file;return rawFile?createUploadedFile(rawFile):null},getFiles(key){const files=this.files||{};const file=files[key];if(!file)return[];const fileArray=Array.isArray(file)?file:[file];return fileArray.map(createUploadedFile)},hasFile(key){const files=this.files||{};return key in files&&files[key]!==undefined},allFiles(){const files=this.files||{};const result={};for(const[key,value]of Object.entries(files)){if(Array.isArray(value))result[key]=value.map((f)=>createUploadedFile(f));else result[key]=createUploadedFile(value)}return result},getParams(){return{...this.params}},isEmpty(){return Object.keys(getAllInputFor(this)).length===0},browser(){return this.headers.get("sec-ch-ua")||this.headers.get("user-agent")},ipForRateLimit(){const ip=this.ip;if(typeof ip==="function")return ip.call(this)||null;return typeof ip==="string"&&ip?ip:null},getMethod(){return this.method.toUpperCase()},async user(){return this._authenticatedUser},async userToken(){return this._currentAccessToken},async tokenCan(ability){if(typeof ability!=="string"||ability.length===0)return false;const token=this._currentAccessToken;if(!token||typeof token!=="object")return false;const abilities=token.abilities;if(!Array.isArray(abilities))return false;if(abilities.includes("*"))return true;return abilities.includes(ability)},async tokenCant(ability){return!await this.tokenCan(ability)},async can(ability,...args){if(typeof ability!=="string"||ability.length===0)return false;const{Gate}=requestGateModule??=await import("@stacksjs/auth/gate");const user=this._authenticatedUser??null;return Gate.allows(ability,user,...args)},async cannot(ability,...args){return!await this.can(ability,...args)},async authorize(ability,...args){const{Gate}=requestGateModule??=await import("@stacksjs/auth/gate");const user=this._authenticatedUser??null;await Gate.authorize(ability,user,...args)}};const stacksRequestPrototypes=new WeakMap;const STACKS_REQUEST_ENHANCED=Symbol.for("stacks.router.requestEnhanced");function fuseRequestEnhancements(router,initializeRequestIds=true){const original=router.enhanceRequest.bind(router);const combinedPrototypes=new WeakMap;router.enhanceRequest=(request,params={})=>{const basePrototype=Object.getPrototypeOf(request);const combined=combinedPrototypes.get(basePrototype);if(combined){const enhanced=request;if(enhanced.params!==params){if("params"in request){Object.defineProperty(enhanced,"params",{value:params,writable:true,configurable:true,enumerable:false})}else{enhanced.params=params}}Object.setPrototypeOf(enhanced,combined);if(initializeRequestIds&&!enhanced._requestId)enhanced._requestId=incomingRequestId(enhanced)??generateRequestId();return enhanced}const enhanced=enhanceRequest(original(request,params),initializeRequestIds);combinedPrototypes.set(basePrototype,Object.getPrototypeOf(enhanced));return enhanced}}let csrfModule;let csrfModuleLoad;function loadCsrfModule(){if(csrfModule!==undefined)return csrfModule;csrfModuleLoad??=import(resolveDefaultsPath("app/Middleware/Csrf.ts")).then((mod)=>{csrfModule=mod;return csrfModule}).catch(()=>{csrfModule=null;return null});return csrfModuleLoad}export function clearCsrfModuleCache(){csrfModule=undefined;csrfModuleLoad=undefined}function applyCsrfRenderToken(req,cookieHeader,mod){const token=mod.generateCsrfToken();req._csrfToken=token;try{const merged=cookieHeader?`${cookieHeader}; ${mod.CSRF_COOKIE_NAME}=${token}`:`${mod.CSRF_COOKIE_NAME}=${token}`;req.headers.set("cookie",merged)}catch{}}function requestMayRenderHtml(req){const accept=req.headers.get("accept");return accept?.includes("text/html")===true||req.headers.get("sec-fetch-dest")==="document"}function cookieHeaderHasName(cookieHeader,name){const needle=`${name}=`;let at=cookieHeader.indexOf(needle);while(at!==-1){let before=at-1;while(before>=0&&cookieHeader.charCodeAt(before)===32)before--;if(before<0||cookieHeader.charCodeAt(before)===59)return true;at=cookieHeader.indexOf(needle,at+1)}return false}function hasCsrfCookie(cookieHeader){return cookieHeader.length!==0&&(cookieHeaderHasName(cookieHeader,"X-CSRF-Token")||cookieHeaderHasName(cookieHeader,"csrf-token"))}function seedCsrfTokenForRender(req,cookieHeader=req.headers?.get?.("cookie")??""){const mod=loadCsrfModule();if(mod===null)return;if(mod instanceof Promise){return mod.then((resolved)=>{if(!resolved)return;if(hasCsrfCookie(cookieHeader)){req._csrfToken=resolved.csrfCookieToken(req)||undefined;return}applyCsrfRenderToken(req,cookieHeader,resolved)})}if(hasCsrfCookie(cookieHeader)){req._csrfToken=mod.csrfCookieToken(req)||undefined;return}applyCsrfRenderToken(req,cookieHeader,mod)}export function enhanceRequest(req,initializeRequestId=true){const routeParams=req.params??{};req.params=routeParams;if(initializeRequestId&&!req._requestId)req._requestId=incomingRequestId(req)??generateRequestId();if(req[STACKS_REQUEST_ENHANCED]===true)return req;applyRequestEnhancements(req,routeParams);const routerPrototype=Object.getPrototypeOf(req);let stacksPrototype=stacksRequestPrototypes.get(routerPrototype);if(!stacksPrototype){stacksPrototype=Object.assign(Object.create(routerPrototype),REQUEST_METHODS);Object.defineProperty(stacksPrototype,STACKS_REQUEST_ENHANCED,{value:true});stacksRequestPrototypes.set(routerPrototype,stacksPrototype)}Object.setPrototypeOf(req,stacksPrototype);return req}const INVALID_REQUEST_ID_CHARACTER=/[^\w.:-]/;function incomingRequestId(req){try{const supplied=req.headers.get("x-request-id")?.trim();if(supplied&&supplied.length>=8&&supplied.length<=200&&!INVALID_REQUEST_ID_CHARACTER.test(supplied))return supplied}catch{}return}const REQUEST_ID_DIGITS="0123456789abcdefghijklmnopqrstuvwxyz";const REQUEST_ID_SUFFIX_COUNT=36;function createRequestIdGenerator(){const prefix=crypto.randomUUID().replaceAll("-","").slice(0,16);let block=0;let suffix=0;let blockPrefix=`${prefix}-0`;return()=>{suffix++;if(suffix===REQUEST_ID_SUFFIX_COUNT){suffix=0;blockPrefix=`${prefix}-${(++block).toString(36)}`}return blockPrefix+REQUEST_ID_DIGITS[suffix]}}let generateRequestId=()=>{generateRequestId=createRequestIdGenerator();return generateRequestId()};function validationFieldErrors(error){const errors=error?.details?.errors;if(!errors||typeof errors!=="object"||Array.isArray(errors))return;const entries=Object.entries(errors);if(entries.length===0||!entries.every(([,messages])=>Array.isArray(messages)&&messages.every((m)=>typeof m==="string")))return;return errors}function createHandlerErrorResponse(error,req,handlerPath,router){if(router?.errorHandler)return Promise.reject(error);report(error,{label:`[Router] ${handlerPath}`});const rawStatus=error?.statusCode??error?.status;const status=typeof rawStatus==="number"&&Number.isInteger(rawStatus)&&rawStatus>=400&&rawStatus<600?rawStatus:undefined;const fieldErrors=status===422?validationFieldErrors(error):undefined;if(fieldErrors)return Promise.resolve(validationFailureResponse(fieldErrors));return createErrorResponse(error instanceof Error?error:new Error(String(error)),req,{handlerPath,status})}function wrapHandler(handler,skipParsing=false,handlerKey=""){if(isRouterAction(handler))return wrapAction(handler,handlerKey);if(typeof handler==="string"){const handlerPath=handler;return async(req)=>{try{if(!skipParsing){await parseRequestBody(req);req=enhanceRequest(req)}const pending=resolveStringHandler(handlerPath);const resolvedHandler=pending instanceof Promise?await pending:pending;return await resolvedHandler(req)}catch(error){return await createHandlerErrorResponse(error,req,handlerPath)}}}const fn=handler;return(req)=>{const result=fn(req);if(result instanceof Promise)return result.then((value)=>formatResult(value,req));return formatResult(result,req)}}function addFormValue(body,key,value){if(!Object.hasOwn(body,key))body[key]=value;else if(Array.isArray(body[key]))body[key].push(value);else body[key]=[body[key],value]}async function parseRequestBody(req){if(req._bodyParsed)return;req._bodyParsed=true;const contentType=req.headers.get("content-type")||"";const mediaType=contentType.toLowerCase();try{if(contentType==="application/json"||JSON_CONTENT_TYPE.test(contentType)){const raw=await req.text();req._rawBody=raw;req._rawBodyContentType=contentType;if(raw.length===0){req.jsonBody={}}else{try{const body=JSON.parse(raw);req.jsonBody=body&&typeof body==="object"?body:{}}catch(parseErr){const message=parseErr instanceof Error?parseErr.message:"Invalid JSON";const{HttpError}=routerHttpErrorModule??=await import("@stacksjs/error-handling/http-error");throw new HttpError(400,`Invalid JSON body: ${message}`)}}}else if(mediaType.includes("application/x-www-form-urlencoded")){const text=await req.clone().text();const params=new URLSearchParams(text);const formBody=Object.create(null);params.forEach((value,key)=>{addFormValue(formBody,key,value)});req.formBody=formBody}else if(mediaType.includes("multipart/form-data")){const formData=await req.clone().formData();const formBody=Object.create(null);const files={};formData.forEach((value,key)=>{if(value instanceof File){if(files[key]){if(Array.isArray(files[key])){files[key].push(value)}else{files[key]=[files[key],value]}}else{files[key]=value}}else{addFormValue(formBody,key,value)}});Reflect.set(req,"formBody",formBody);Reflect.set(req,"files",files)}}catch(e){const status=e?.status??e?.statusCode;if(typeof status==="number")throw e;log.debug("[stacks-router] Body parsing failed:",e)}}let signedStorageModule;function isActiveContentType(contentType){const type=contentType.split(";")[0].trim().toLowerCase();return type==="text/html"||type==="application/xhtml+xml"||type==="image/svg+xml"||type==="text/xml"||type==="application/xml"||type.endsWith("+xml")||type==="text/javascript"||type==="application/javascript"||type==="application/ecmascript"}function attachmentDisposition(path){const name=path.split("/").pop()||"download";const ascii=name.replace(/[^\x20-\x7E]|["\\]/g,"_");return`attachment; filename="${ascii}"; filename*=UTF-8''${encodeURIComponent(name)}`}async function answerPreflight(req){try{const cors=await import(resolveDefaultsPath("app/Middleware/Cors.ts"));return cors.buildPreflightResponse(req,cors.getResolvedCorsConfig())}catch(error){log.warn("[router] CORS preflight could not load the CORS policy; answering without CORS headers",{error});return new Response(null,{status:204})}}export function createStacksRouter(config={}){const bunRouter=new Router({verbose:config.verbose??false,preflight:answerPreflight});if(config.autoDiscoverRoutes===false){bunRouter._apiRoutesInitialized=true}const requestContextEnabled=config.requestContext!==false;setAmbientRequestContext(requestContextEnabled);if(!requestContextEnabled)routersWithoutRequestContext.add(bunRouter);const csrfEnabled=config.csrf!==false;if(csrfEnabled)csrfEnabledNativeRouteRouters.add(bunRouter);fuseRequestEnhancements(bunRouter,config.requestIds!==false);let currentPrefix="";let currentGroupMiddleware=[];let currentGroupApiResponse=false;const routeStates=new Map;function registerRoute(method,path,_handler){const fullPath=currentPrefix+braceParams(path);const routeKey=`${method}:${fullPath}`;const handlerKind=_handler instanceof Response?"static response":typeof _handler==="string"?_handler:"function";log.debug(`[router] ${method} ${fullPath} → ${handlerKind}`);const withheldBecause=routeAdmission&&typeof _handler==="string"?routeAdmission(_handler):undefined;if(withheldBecause){withheldRoutes.push({method,path:fullPath,handler:_handler,reason:withheldBecause});return{fullPath,routeKey,shadowed:true,withheld:true}}const shadowed=routeStates.has(routeKey)||clearedRouteKeysByRegistry.get(routeStates)?.has(routeKey)===true;if(!shadowed){const routeState={csrfMode:CSRF_DEFAULT};if(currentGroupMiddleware.length>0)routeState.middleware=[...currentGroupMiddleware];routeStates.set(routeKey,routeState);routeStateRegistries.add(routeStates)}if(!shadowed&&currentGroupApiResponse){const registry=routeApiResponseRegistry??=new Set;registry.add(routeKey)}if(!shadowed&&typeof _handler==="string"){routeHandlerKeyRegistry.set(routeKey,_handler)}if(!shadowed&&isRouterAction(_handler)){const registry=routeActionRegistry??=new Map;registry.set(routeKey,_handler)}return{fullPath,routeKey,shadowed,withheld:false}}const stacksRouter={bunRouter,get routes(){return bunRouter.routes},staticResponse(method,path,response){if(!STATIC_RESPONSE_METHODS.has(method)){throw new TypeError(`[Router] staticResponse(): unsupported HTTP method '${String(method)}'`)}if(!(response instanceof Response)){throw new TypeError("[Router] staticResponse(): response must be a prebuilt Response")}if(currentGroupMiddleware.length>0){throw new Error("[Router] staticResponse() cannot be registered inside a group with middleware because static responses bypass middleware")}if(currentGroupApiResponse){throw new Error("[Router] staticResponse() cannot be registered inside a group with apiResponse because static responses bypass response formatting")}const{fullPath,shadowed}=registerRoute(method,path,response);if(!shadowed){switch(method){case"GET":bunRouter.get(fullPath,response);break;case"POST":bunRouter.post(fullPath,response);break;case"PUT":bunRouter.put(fullPath,response);break;case"PATCH":bunRouter.patch(fullPath,response);break;case"DELETE":bunRouter.delete(fullPath,response);break;case"OPTIONS":bunRouter.options(fullPath,response);break}}return stacksRouter},get(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("GET",path,handler);if(!withheld)bunRouter.get(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},post(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("POST",path,handler);if(!withheld)bunRouter.post(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},put(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("PUT",path,handler);if(!withheld)bunRouter.put(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},patch(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("PATCH",path,handler);if(!withheld)bunRouter.patch(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},delete(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("DELETE",path,handler);if(!withheld)bunRouter.delete(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},options(path,handler){const{fullPath,routeKey,shadowed,withheld}=registerRoute("OPTIONS",path,handler);if(!withheld)bunRouter.options(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));return createChainableRoute(routeStates,routeKey,shadowed)},redirect(from,to,status=302){if(!REDIRECT_STATUSES.has(status))throw new TypeError(`[Router] redirect(): ${status} is not a redirect status (use 301, 302, 303, 307 or 308)`);if(!to)throw new TypeError(`[Router] redirect(): '${from}' needs somewhere to go`);const handler=(request)=>{const search=new URL(request.url).search;const location=search&&!to.includes("?")?`${to}${search}`:to;return new Response(null,{status,headers:{Location:location}})};const{fullPath,routeKey,shadowed}=registerRoute("GET",from,handler);bunRouter.get(fullPath,createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled));if(!shadowed)(redirectRouteRegistry??=new Map).set(fullPath,{path:fullPath,to,status});return createChainableRoute(routeStates,routeKey,shadowed)},permanentRedirect(from,to){return stacksRouter.redirect(from,to,301)},group(options,callback){const previousPrefix=currentPrefix;const previousMiddleware=[...currentGroupMiddleware];const previousApiResponse=currentGroupApiResponse;const restoreGroupState=()=>{currentPrefix=previousPrefix;currentGroupMiddleware=previousMiddleware;currentGroupApiResponse=previousApiResponse};if(options.prefix){currentPrefix=previousPrefix+braceParams(options.prefix)}const middlewareList=options.middleware?Array.isArray(options.middleware)?options.middleware:[options.middleware]:undefined;if(middlewareList){currentGroupMiddleware=[...currentGroupMiddleware,...middlewareList]}if(options.apiResponse===true){currentGroupApiResponse=true}log.debug(`[router] Entering group: prefix=${options.prefix||"/"} middleware=[${middlewareList?.join(", ")||""}]${currentGroupApiResponse?" apiResponse=true":""}`);let result;try{result=callback()}catch(error){restoreGroupState();throw error}if(result instanceof Promise){return result.then(()=>stacksRouter).finally(restoreGroupState)}restoreGroupState();return stacksRouter},resource(name,handler,options){const actions=["index","store","show","update","destroy"];const activeActions=options?.only?actions.filter((a)=>options.only.includes(a)):options?.except?actions.filter((a)=>!options.except.includes(a)):actions;const stripped=handler.replace(/Action$/,"");const handlerBase=stripped.startsWith("Actions/")?stripped:`Actions/${stripped}`;log.debug(`[router] Resource: /${name} → ${handlerBase}*Action [${activeActions.join(", ")}]`);const sibling=(suffix)=>`${handlerBase}${suffix}`;const registerResourceRoutes=()=>{for(const action of activeActions){switch(action){case"index":stacksRouter.get(`/${name}`,sibling("IndexAction"));break;case"store":stacksRouter.post(`/${name}`,sibling("StoreAction"));break;case"show":stacksRouter.get(`/${name}/:id`,sibling("ShowAction"));break;case"update":stacksRouter.put(`/${name}/:id`,sibling("UpdateAction"));break;case"destroy":stacksRouter.delete(`/${name}/:id`,sibling("DestroyAction"));break}}};if(options?.middleware){stacksRouter.group({middleware:options.middleware},registerResourceRoutes)}else{registerResourceRoutes()}return stacksRouter},match(methods,path,handler){log.debug(`[router] Match: [${methods.join(", ")}] ${path} → ${typeof handler==="string"?handler:"function"}`);const routeKeys=[];for(const method of methods){const m=method.toUpperCase();const{fullPath,routeKey,shadowed,withheld}=registerRoute(m,path,handler);if(withheld)continue;if(!shadowed)routeKeys.push(routeKey);const wrappedHandler=createMiddlewareHandler(bunRouter,routeStates,routeKey,handler,csrfEnabled);switch(m){case"GET":bunRouter.get(fullPath,wrappedHandler);break;case"POST":bunRouter.post(fullPath,wrappedHandler);break;case"PUT":bunRouter.put(fullPath,wrappedHandler);break;case"PATCH":bunRouter.patch(fullPath,wrappedHandler);break;case"DELETE":bunRouter.delete(fullPath,wrappedHandler);break;case"OPTIONS":bunRouter.options(fullPath,wrappedHandler);break}}return createChainableRoute(routeStates,routeKeys[0]??"",routeKeys.length===0,routeKeys.slice(1))},health(){bunRouter.get("/api/health",async()=>{const{checkApplicationHealth}=await import("./health");const health=await checkApplicationHealth();return Response.json(health,{status:health.status==="healthy"?200:503})});bunRouter.get("/__routes",(req)=>{if(!isExposeRoutesAuthorized(req))return Response.json({error:"disabled"},{status:404});return Response.json(listRegisteredRoutes())});bunRouter.get("/__storage/{path}",async(req)=>{const url=new URL(req.url);const token=url.searchParams.get("token");const params=req.params;const rawPath=params?.path?params.path:decodeURIComponent(url.pathname.replace(/^\/__storage\//,""));if(!token||typeof rawPath!=="string"||rawPath.length===0){return new Response("Forbidden",{status:403})}const{verifySignedStorageToken,Storage}=signedStorageModule??=await import("@stacksjs/storage");const v=verifySignedStorageToken(token,rawPath);if(!v.valid){return new Response("Forbidden",{status:403})}try{let adapter;if(v.claims?.disk){try{adapter=Storage.disk(v.claims.disk)}catch{return new Response("Not Found",{status:404})}}else{adapter=Storage.disk()}const exists=await adapter.fileExists(rawPath);if(!exists)return new Response("Not Found",{status:404});const buf=await adapter.readToBuffer(rawPath);const mime=await adapter.mimeType(rawPath).catch(()=>"application/octet-stream");const headers={"Content-Type":mime,"Cache-Control":"private, max-age=60","X-Content-Type-Options":"nosniff"};if(isActiveContentType(mime)){headers["Content-Disposition"]=attachmentDisposition(rawPath);headers["Content-Security-Policy"]="sandbox"}return new Response(buf,{status:200,headers})}catch(err){log.error("[storage] signed-url fetch failed:",err);return new Response("Internal Error",{status:500})}});bunRouter.get("/__openapi.json",async(req)=>{if(!isExposeRoutesAuthorized(req))return Response.json({error:"disabled"},{status:404});try{const{generateOpenApi}=await import("@stacksjs/api");const spec=await generateOpenApi({write:false,portable:false});return Response.json(spec)}catch(err){return Response.json({error:"OpenAPI generation failed",message:err instanceof Error?err.message:String(err)},{status:500})}});return stacksRouter},use(middleware){const adapted=adaptMiddlewareForBunRouter(middleware);bunRouter.globalMiddleware.push(adapted);return stacksRouter},booting(name,run){bootHooks.push({name,run});return stacksRouter},stopping(name,run){shutdownHooks().hooks.push({name,run});return stacksRouter},async serve(options={}){const{overridesReady}=await import("@stacksjs/config");await overridesReady;if(requestCaptureEnabled()&&!shutdownHooks().hooks.some((hook)=>hook.name==="http-capture"))shutdownHooks().hooks.push({name:"http-capture",run:flushRequestCaptures});warnOnMultipleRouterInstances();configureViewDirectories(bunRouter);if(csrfEnabled)wrapHandleRequestForCsrf(bunRouter);await wrapHandleRequestForDatabaseContext(bunRouter);await runBootHooks();const appEnv=(process.env.APP_ENV??"").toLowerCase();const production=appEnv==="production"||process.env.NODE_ENV==="production";const callerSuppliedRoutes=Object.prototype.hasOwnProperty.call(options,"routes");const nativeRoutes=options.nativeRoutes??(production&&!callerSuppliedRoutes&&shouldUseNativeRoutesByDefault(bunRouter.routes));if(options.tls)secureNativeRouteRouters.add(bunRouter);else secureNativeRouteRouters.delete(bunRouter);return bunRouter.serve(nativeRoutes===options.nativeRoutes?options:{...options,nativeRoutes})},handleRequest(req){return requestCaptureEnabled()?observeHttpRequest(req,()=>bunRouter.handleRequest(req)):bunRouter.handleRequest(req)},getAllowedMethods(pathname,domain){return bunRouter.getAllowedMethods(pathname,domain)},async register(routePath,options){log.debug(`[router] Register: ${routePath} prefix=${options?.prefix||"none"}`);const callback=async()=>{await import(routePath)};if(options?.prefix||options?.middleware){await stacksRouter.group({prefix:options.prefix,middleware:options.middleware},callback)}else{await callback()}return stacksRouter},async importRoutes(){log.debug("[router] Loading user routes from registry...");try{const{appRouteRegistry,loadRoutes}=await import("./route-loader");await loadRoutes(await appRouteRegistry())}catch(error){log.error("Failed to load route registry:",error);throw error}log.debug("[router] Loading ORM routes...");const ormRoutesPackage="@stacksjs/orm/routes";let ormRoutesLoaded=false;try{await import(ormRoutesPackage);ormRoutesLoaded=true;log.debug(`[router] ORM routes loaded from ${ormRoutesPackage}`)}catch(error){log.debug(`[router] ORM routes not available from the package, trying the vendored copy
5
+ `,error)}const ormRoutesCandidates=ormRoutesLoaded?[]:[frameworkPath("orm/routes.ts"),frameworkPath("core/orm/routes.ts")];for(const candidate of ormRoutesCandidates){try{if(await Bun.file(candidate).exists()){await import(candidate);ormRoutesLoaded=true;log.info(`[router] ORM routes loaded from the vendored copy at ${candidate}. This file is not refreshed by upgrading @stacksjs/orm - delete it to use the package.`);break}}catch(error){log.warn(`[router] ORM routes candidate failed to load, falling back to next: ${candidate}
6
+ `,error)}}if(!ormRoutesLoaded)log.warn("[router] No ORM routes candidate loaded - model useApi endpoints are unavailable.");log.debug("[router] Loading discovered package routes...");try{await stacksRouter.loadDiscoveredRoutes()}catch(error){log.debug("Package route discovery skipped:",error)}await assertRouteMiddlewareResolvable()},async loadDiscoveredRoutes(){try{const manifestPath=storagePath("framework/discovered-packages.json");const file=Bun.file(manifestPath);if(!await file.exists())return;const manifest=await file.json();const packages=manifest?.packages;if(!packages)return;for(const[pkgName,meta]of Object.entries(packages)){const routes=meta?.routes;if(!routes)continue;const routeList=Array.isArray(routes)?routes:[routes];const pkgDir=meta?.root?projectPath(meta.root):`${projectPath("pantry")}/${pkgName}`;for(const routeFile of routeList){log.debug(`[router] Discovered route: ${pkgName} → ${routeFile}`);const fullPath=routeFile.startsWith("/")?routeFile:`${pkgDir}/${routeFile}`;const prefix=meta?.routePrefix;const middleware=meta?.routeMiddleware;try{await stacksRouter.register(fullPath,{prefix,middleware})}catch(err){log.warn(`Failed to load routes from package '${pkgName}': ${err}`)}}}}catch{}}};return stacksRouter}function wrapHandleRequestForCsrf(bunRouter){const router=bunRouter;if(router._csrfSeedingWrapped)return;const original=router.handleRequest.bind(router);const handleUnseededSafeRequest=async(request,rendersCsrf,cookieHeader)=>{if(rendersCsrf&&requestMayRenderHtml(request)){const seeding=seedCsrfTokenForRender(request,cookieHeader);if(seeding)await seeding}request[CSRF_SEEDED_BY_HANDLE_REQUEST]=true;const response=await original(request);if(!response)return response;try{const mod=loadCsrfModule();const csrf=mod instanceof Promise?await mod:mod;if(!csrf)return response;return csrf.seedCsrfCookieIfMissing(request,response,request._csrfToken)}catch(err){log.warn("[router] CSRF cookie seeding failed on the view path",{error:err});return response}};const handleSafeRequest=(request,rendersCsrf)=>{const cookieHeader=request.headers.get("cookie")??"";if(hasCsrfCookie(cookieHeader)){if(rendersCsrf&&requestMayRenderHtml(request)){const seeding=seedCsrfTokenForRender(request,cookieHeader);if(seeding){return seeding.then(()=>{request[CSRF_SEEDED_BY_HANDLE_REQUEST]=true;return original(request)})}}request[CSRF_SEEDED_BY_HANDLE_REQUEST]=true;return original(request)}return handleUnseededSafeRequest(request,rendersCsrf,cookieHeader)};router.handleRequest=(request)=>{const method=request.method;if(method==="GET"||method==="HEAD")return handleSafeRequest(request,true);if(method==="OPTIONS")return handleSafeRequest(request,false);return original(request)};router._csrfSeedingWrapped=true}export function configureViewDirectories(bunRouter){const router=bunRouter;if(typeof router.views!=="function")return;const existing=router._fileRoutingConfig;if(existing&&Object.keys(existing).length>0)return;if(!existsSync(projectPath("resources/views")))return;const layouts=[projectPath("resources/views/layouts"),projectPath("resources/layouts")].find(existsSync);const partials=[projectPath("resources/views/partials"),projectPath("resources/partials")].find(existsSync);const components=[projectPath("resources/components"),projectPath("resources/views/components")].find(existsSync);router.views({...components?{componentsDir:components}:{},...layouts?{layoutsDir:layouts}:{},...partials?{partialsDir:partials}:{}})}export function disableViewRouting(bunRouter){const router=bunRouter;if(typeof router.disableFileRouting!=="function")return false;const existing=router._fileRoutingConfig;if(existing&&Object.keys(existing).length>0)return false;router.disableFileRouting();return true}const ROUTE_SINGLETON_KEY=Symbol.for("@stacksjs/router:route-singleton");export const route=globalThis[ROUTE_SINGLETON_KEY]??=createStacksRouter();let routesLoadPromise=null;let routingContextDispatcher=null;const databaseContextWrappedRouters=new WeakSet;function applyDirectNativeCookies(router,response,request){const cookieChanges=request;return cookieChanges._cookiesToSet?.length||cookieChanges._cookiesToDelete?.length?router.applyModifiedCookies(response,request):response}function nativeRouteErrorResponse(error){return new Response(JSON.stringify({success:false,message:"Internal Server Error",error:error instanceof Error?error.message:String(error)}),{status:500,headers:{"Content-Type":"application/json","Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, PUT, DELETE, PATCH, OPTIONS","Access-Control-Allow-Headers":"Content-Type, Authorization, X-Requested-With, Accept, Origin"}})}function handleDirectNativeRouteError(router,error){console.error("Error handling request:",error);return router.errorHandler?router.errorHandler(error instanceof Error?error:new Error(String(error))):nativeRouteErrorResponse(error)}function directNativePath(path){const segments=path.split("/");for(let index=0;index<segments.length;index++){const segment=segments[index];if(!segment)continue;const parameter=segment.match(/^\{([A-Z_$][\w$]*)\}$/i);if(parameter){segments[index]=`:${parameter[1]}`;continue}if(segment.includes("{")||segment.includes(":")||segment.includes("*"))return}return segments.join("/")}function buildDirectNativeHandlers(router,finalizeResponse){const nativeRouter=router;const handlers=new Map;if(nativeRouter.globalMiddleware.length!==0)return handlers;const enterBunRouterContext=routersWithoutRequestContext.has(router)?(_req,fn)=>fn():runWithBunRouterRequest;for(const route of nativeRouter.routes){if(!isNativeRouteMethod(route.method)||route.nativeDispatch===false||route.constraints&&Object.keys(route.constraints).length>0||(route.middleware?.length??0)!==0||typeof route.handler!=="function"||!stacksRouteHandlers.has(route.handler)){continue}const handler=route.handler;const nativePath=directNativePath(route.path);if(!nativePath)continue;const key=`${route.method}:${nativePath}`;if(handlers.has(key))continue;handlers.set(key,(request)=>{const nativeParams=request.params??{};const enhancedRequest=nativeRouter.enhanceRequest(request,nativeParams);enhancedRequest.route=route;const requestMarkers=enhancedRequest;if(typeof requestMarkers[CSRF_SECURE_TRANSPORT]!=="boolean")requestMarkers[NATIVE_DIRECT_ROUTE_REQUEST]=true;return enterBunRouterContext(enhancedRequest,()=>{try{const response=handler(enhancedRequest);return response instanceof Response?finalizeResponse(applyDirectNativeCookies(nativeRouter,response,enhancedRequest),request):response.then((result)=>finalizeResponse(applyDirectNativeCookies(nativeRouter,result,enhancedRequest),request),(error)=>{const result=handleDirectNativeRouteError(nativeRouter,error);return result instanceof Response?finalizeResponse(result,request):result.then((response)=>finalizeResponse(response,request))})}catch(error){const result=handleDirectNativeRouteError(nativeRouter,error);return result instanceof Response?finalizeResponse(result,request):result.then((response)=>finalizeResponse(response,request))}})})}return handlers}function wrapNativeRoutesForDatabaseContext(router,dispatchInRoutingContext){const nativeRouter=router;if(nativeRouter._nativeDatabaseContextWrapped||typeof nativeRouter._buildNativeRoutes!=="function")return;const buildNativeRoutes=nativeRouter._buildNativeRoutes.bind(nativeRouter);nativeRouter._buildNativeRoutes=()=>{const routes=buildNativeRoutes();if(!routes)return routes;const compression=nativeRouter.config.compression;const compressionDisabled=compression?.enabled===false;const compressionThreshold=compression?.threshold??1024;const finalizeResponse=(response,request)=>{const frameworkResponse=response;const bodySizeUpperBound=frameworkResponse[FRAMEWORK_RESPONSE_BODY_SIZE_UPPER_BOUND];if(compressionDisabled||typeof bodySizeUpperBound==="number"&&bodySizeUpperBound<compressionThreshold)return response;if(bodySizeUpperBound===undefined){const declaredLength=response.headers.get("content-length");if(declaredLength!==null){const length=Number(declaredLength);if(Number.isSafeInteger(length)&&length>=0&&length<compressionThreshold)return response}}return applyResponseCompression(response,request,compression)};const directHandlers=buildDirectNativeHandlers(router,finalizeResponse);const secureTransport=secureNativeRouteRouters.has(router);const csrfEnabled=csrfEnabledNativeRouteRouters.has(router);for(const[path,methods]of Object.entries(routes)){for(const[method,handler]of Object.entries(methods)){const safeMethod=method==="GET"||method==="HEAD"||method==="OPTIONS";const directDispatch=directHandlers.get(`${method}:${path}`)??(method==="HEAD"?directHandlers.get(`GET:${path}`):undefined);if(directDispatch){if(safeMethod&&csrfEnabled){methods[method]=(request)=>{const cookie=request.headers.get("cookie")??"";const markedRequest=request;if(hasCsrfCookie(cookie))markedRequest[CSRF_SEEDED_BY_HANDLE_REQUEST]=true;else markedRequest[CSRF_SECURE_TRANSPORT]=secureTransport;return dispatchInRoutingContext(directDispatch,request)}}else{methods[method]=(request)=>dispatchInRoutingContext(directDispatch,request)}continue}methods[method]=(request)=>{if(safeMethod&&csrfEnabled){const cookie=request.headers.get("cookie")??"";const markedRequest=request;if(hasCsrfCookie(cookie)){markedRequest[CSRF_SEEDED_BY_HANDLE_REQUEST]=true}else{markedRequest[CSRF_SECURE_TRANSPORT]=secureTransport}}const response=dispatchInRoutingContext(handler,request);return response instanceof Response?finalizeResponse(response,request):response.then((resolved)=>finalizeResponse(resolved,request))}}}if(requestCaptureEnabled()){for(const methods of Object.values(routes)){for(const[method,handler]of Object.entries(methods))methods[method]=(request)=>observeHttpRequest(request,()=>handler(request))}}return routes};nativeRouter._nativeDatabaseContextWrapped=true}async function wrapHandleRequestForDatabaseContext(router){if(databaseContextWrappedRouters.has(router))return;const dispatchInRoutingContext=await getRoutingContextDispatcher();if(databaseContextWrappedRouters.has(router))return;wrapNativeRoutesForDatabaseContext(router,dispatchInRoutingContext);const original=router.handleRequest.bind(router);router.handleRequest=(request)=>requestCaptureEnabled()?observeHttpRequest(request,()=>dispatchInRoutingContext(original,request)):dispatchInRoutingContext(original,request);databaseContextWrappedRouters.add(router)}async function getRoutingContextDispatcher(){if(!routingContextDispatcher){try{let database=await import("@stacksjs/database/replicas");if(typeof database.runInDatabaseRoutingContext!=="function"&&typeof database.withDatabaseRoutingContext!=="function")database=await import("@stacksjs/database/runtime");const dispatcher=database.runInDatabaseRoutingContext;const runner=database.withDatabaseRoutingContext??database.withRoutingContext;routingContextDispatcher=typeof dispatcher==="function"?dispatcher:typeof runner==="function"?(fn,arg)=>runner(()=>fn(arg)):(fn,arg)=>fn(arg)}catch{routingContextDispatcher=(fn,arg)=>fn(arg)}}return routingContextDispatcher}export function serverResponse(request,_body){if(routingContextDispatcher)return routingContextDispatcher(handleServerRequest,request);return dispatchServerRequestAfterContextInit(request)}async function dispatchServerRequestAfterContextInit(request){const dispatchInRoutingContext=await getRoutingContextDispatcher();return dispatchInRoutingContext(handleServerRequest,request)}let handleServerRequest=handleServerRequestBeforeRoutes;async function handleServerRequestBeforeRoutes(request){if(!routesLoadPromise){log.debug("[router] Loading routes for first time...");routesLoadPromise=route.importRoutes().catch((err)=>{routesLoadPromise=null;throw err})}await routesLoadPromise;handleServerRequest=handleLoadedServerRequest;return handleLoadedServerRequest(request)}async function handleLoadedServerRequest(request){const response=await route.handleRequest(request);if(response[ENRICHED_NOT_FOUND_RESPONSE]===true)return response;if(response.status===404&&response.headers.get("content-type")?.includes("json")){try{const url=new URL(request.url);const path=url.pathname;const method=request.method;const text=await response.clone().text();const alreadyEnriched=text===JSON.stringify({success:false,message:"Not Found",path,method})||text===JSON.stringify({error:"Not Found",path,method});if(alreadyEnriched)return response;const body=JSON.parse(text);const isGeneric=body?.message==="Not Found"||body?.error==="Not Found";if(isGeneric){const enriched={...body,path,method};return new Response(JSON.stringify(enriched),{status:404,headers:response.headers})}}catch{}}return response}export async function serve(options={}){return route.serve(options)}
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@stacksjs/router",
3
3
  "type": "module",
4
4
  "sideEffects": false,
5
- "version": "0.75.514",
5
+ "version": "0.75.518",
6
6
  "description": "The Stacks framework router.",
7
7
  "author": "Chris Breuer",
8
8
  "contributors": [
@@ -68,27 +68,27 @@
68
68
  },
69
69
  "dependencies": {
70
70
  "@stacksjs/bun-router": "^0.1.24",
71
- "@stacksjs/cache": "0.75.514",
72
- "@stacksjs/collections": "0.75.514",
73
- "@stacksjs/config": "0.75.514",
74
- "@stacksjs/error-handling": "0.75.514",
75
- "@stacksjs/logging": "0.75.514",
76
- "@stacksjs/pagination": "0.75.514",
77
- "@stacksjs/path": "0.75.514",
78
- "@stacksjs/security": "0.75.514",
79
- "@stacksjs/storage": "0.75.514",
71
+ "@stacksjs/cache": "0.75.518",
72
+ "@stacksjs/collections": "0.75.518",
73
+ "@stacksjs/config": "0.75.518",
74
+ "@stacksjs/error-handling": "0.75.518",
75
+ "@stacksjs/logging": "0.75.518",
76
+ "@stacksjs/pagination": "0.75.518",
77
+ "@stacksjs/path": "0.75.518",
78
+ "@stacksjs/security": "0.75.518",
79
+ "@stacksjs/storage": "0.75.518",
80
80
  "ts-rate-limiter": "^0.4.10"
81
81
  },
82
82
  "devDependencies": {
83
- "@stacksjs/actions": "0.75.514",
84
- "@stacksjs/types": "0.75.514",
83
+ "@stacksjs/actions": "0.75.518",
84
+ "@stacksjs/types": "0.75.518",
85
85
  "better-dx": "^0.2.24"
86
86
  },
87
87
  "peerDependencies": {
88
- "@stacksjs/api": "0.75.514",
89
- "@stacksjs/auth": "0.75.514",
90
- "@stacksjs/database": "0.75.514",
91
- "@stacksjs/validation": "0.75.514"
88
+ "@stacksjs/api": "0.75.518",
89
+ "@stacksjs/auth": "0.75.518",
90
+ "@stacksjs/database": "0.75.518",
91
+ "@stacksjs/validation": "0.75.518"
92
92
  },
93
93
  "peerDependenciesMeta": {
94
94
  "@stacksjs/api": {