@stacksjs/router 0.75.611 → 0.75.613
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/error-handler.js +1 -1
- package/dist/index.d.ts +29 -1
- package/dist/index.js +1 -1
- package/dist/refuse.d.ts +24 -0
- package/dist/refuse.js +1 -0
- package/dist/request-augmentation.d.ts +14 -5
- package/dist/stacks-router.d.ts +2 -0
- package/dist/stacks-router.js +1 -1
- package/package.json +16 -16
package/dist/error-handler.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
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
|
|
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){const text=(value)=>typeof value==="string"&&value!==""?value:undefined;return{id:authed.id,email:text(authed.email),name:text(authed.name)??text(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
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,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""");return new Response(`
|
|
3
3
|
<html>
|
|
4
4
|
<head><title>Error</title></head>
|
package/dist/index.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import './request-augmentation';
|
|
|
2
2
|
export type { JsonParseOptions } from './json';
|
|
3
3
|
// Re-export the augmentation types so userland can refer to the marker
|
|
4
4
|
// surface explicitly when needed.
|
|
5
|
-
export type { StacksRequestExtensions, StacksRequestMacros, StacksRequestMarkers } from './request-augmentation';
|
|
5
|
+
export type { AuthenticatedUser, StacksRequestExtensions, StacksRequestMacros, StacksRequestMarkers } from './request-augmentation';
|
|
6
6
|
export type { BootHook, ShutdownHook, StacksRouterConfig } from './stacks-router';
|
|
7
7
|
export type { MiddlewareAliases, MiddlewareClasses, MiddlewareClassName, MiddlewareConfig, Request } from './middleware';
|
|
8
8
|
// Export route loader
|
|
@@ -19,6 +19,7 @@ export type { ChainableRoute, RedirectRoute, RedirectStatus, RouteMonitorOption,
|
|
|
19
19
|
export type { PathParamRejection, SanitizePathParamOptions } from './path-sanitize';
|
|
20
20
|
export type { ApplicationHealthCheck, ApplicationHealthResult, HealthProbe, HealthProbeOptions } from './health';
|
|
21
21
|
export type { StreamOptions } from './stacks-router';
|
|
22
|
+
export type { FormRefusal, RefuseOptions } from './refuse';
|
|
22
23
|
export type { SignedUrlOptions, SignedUrlVerifyResult } from './signed-url';
|
|
23
24
|
export type { EncryptedSessionStoreOptions } from './encrypted-session-store';
|
|
24
25
|
export type {
|
|
@@ -28,6 +29,30 @@ export type {
|
|
|
28
29
|
SessionStore,
|
|
29
30
|
StacksSessionConfig,
|
|
30
31
|
} from './session-factory';
|
|
32
|
+
/**
|
|
33
|
+
* Augmentation target: the types an application gives the request.
|
|
34
|
+
*
|
|
35
|
+
* `user` is the type of the signed-in user the Auth middleware stamps on
|
|
36
|
+
* `request._authenticatedUser`. `@stacksjs/orm` registers its `UserModel`,
|
|
37
|
+
* which an app narrows to its own User by augmenting `UserModel`. With
|
|
38
|
+
* nothing registered, the user is anything with an `id`.
|
|
39
|
+
*
|
|
40
|
+
* Declared here, in the entry, rather than beside the markers: an
|
|
41
|
+
* augmentation merges into the module it names, and an interface that is only
|
|
42
|
+
* re-exported from here would get a second, unrelated declaration that the
|
|
43
|
+
* markers never see (the same trap bun-router's `RouterTypeRegistry` notes).
|
|
44
|
+
*
|
|
45
|
+
* @example
|
|
46
|
+
* ```ts
|
|
47
|
+
* declare module '@stacksjs/router' {
|
|
48
|
+
* interface RequestTypeRegistry {
|
|
49
|
+
* user: UserModel
|
|
50
|
+
* }
|
|
51
|
+
* }
|
|
52
|
+
* ```
|
|
53
|
+
*/
|
|
54
|
+
// eslint-disable-next-line ts/no-empty-object-type -- augmentation target; empty by design
|
|
55
|
+
export declare interface RequestTypeRegistry {}
|
|
31
56
|
export { readJsonBody, readTextBody, RequestBodyError } from './body';
|
|
32
57
|
export { parseJsonText } from './json';
|
|
33
58
|
// Re-export everything from bun-router (includes response factory)
|
|
@@ -105,6 +130,9 @@ export { checkApplicationHealth, runHealthProbes } from './health';
|
|
|
105
130
|
// `stream(asyncGen, { type: 'sse' })` and the router pipes it back
|
|
106
131
|
// with the right Content-Type + no-cache headers.
|
|
107
132
|
export { stream } from './stacks-router';
|
|
133
|
+
// Refuse a browser form from inside `handle()`: `{ error }` for a caller that
|
|
134
|
+
// asked for data, its page with the message for a browser (stacksjs/stacks#3311).
|
|
135
|
+
export { FORM_REFUSAL, formRefusalOf, refuse } from './refuse';
|
|
108
136
|
// Signed-URL helpers — HMAC over the URL + optional expiry so single-
|
|
109
137
|
// use links (email verify, password reset, unsubscribe) can be handed
|
|
110
138
|
// out without long-lived bearer tokens. Pair `signedUrl(...)` with the
|
package/dist/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./request-augmentation";export{readJsonBody,readTextBody,RequestBodyError}from"./body";export{parseJsonText}from"./json";export*from"@stacksjs/bun-router";export{assertRouteMiddlewareResolvable,configureViewDirectories,clearCsrfModuleCache,clearMiddlewareCache,createStacksRouter,disableViewRouting,enhanceRequest,findUnresolvableRouteMiddleware,installMiddlewareHotReload,loadMiddlewareHandlers,resetBootHooks,resetShutdownHooks,route,runBootHooks,runShutdownHooks,serve,serverResponse,url,warnOnMultipleRouterInstances}from"./stacks-router";export{cacheRequestQuery,clearCurrentRequest,getCurrentRequest,getTraceId,request,runWithRequest,setCurrentRequest,withTraceId}from"./request-context";export{defineMiddleware,Middleware}from"./middleware";export{appRouteRegistry,bundleMounts,DEFAULT_ROUTE_BUNDLE_FEATURES,DEFAULT_ROUTE_REGISTRY,listRootMountedAppRoutes,loadRoutes,mountedDefaultRouteBundles}from"./route-loader";export{clearTrackedQueries,createErrorResponse,createMiddlewareErrorResponse,createNotFoundResponse,createValidationErrorResponse,getQueryShapeCounts,trackQuery}from"./error-handler";export{listNamedRoutes,listRedirectRoutes,listRegisteredRoutes,routeParams}from"./stacks-router";export{DASHBOARD_ROUTE_GROUPS,dashboardGroupMiddleware,describeUnknownDashboardGroups,resolveDashboardAccess}from"./dashboard-access";export{isRouterAction,provideActions,provideMiddleware,resolveActionHandler,resolveActionValidations,wrapAction}from"./stacks-router";export{withRouteAdmission}from"./stacks-router";export{createTypedRouter}from"./typed-router";export{clearRouteModelBindings,defineRouteModelBinding,resolveRouteModel,routeModelBindings,setRouteModelFallback}from"./route-model-binding";export{isApiRequest,JSON_CONTENT_TYPE}from"./api-shape";export{rateLimit,rateLimitStatus,clearRateLimit,resetRateLimiters}from"./rate-limit";export{cacheRedisConnection,clientAddress,fallbackStorage,rateLimitScale,resetSharedRateLimitStorage,scaledLimit,sharedRateLimitStorage,trustedProxies,useRateLimitStorage}from"./security-settings";export{PathParamError,safePathParam,sanitizePathParam}from"./path-sanitize";export{checkApplicationHealth,runHealthProbes}from"./health";export{stream}from"./stacks-router";export{signedUrl,signUrl,verifySignedUrl,verifySignedUrlMiddleware}from"./signed-url";export{EncryptedSessionStore}from"./encrypted-session-store";export{createSessionStore,createStacksSessionStore,DatabaseSessionStore,FileSessionStore,MemorySessionStore,RedisSessionStore}from"./session-factory";
|
|
1
|
+
import"./request-augmentation";export{readJsonBody,readTextBody,RequestBodyError}from"./body";export{parseJsonText}from"./json";export*from"@stacksjs/bun-router";export{assertRouteMiddlewareResolvable,configureViewDirectories,clearCsrfModuleCache,clearMiddlewareCache,createStacksRouter,disableViewRouting,enhanceRequest,findUnresolvableRouteMiddleware,installMiddlewareHotReload,loadMiddlewareHandlers,resetBootHooks,resetShutdownHooks,route,runBootHooks,runShutdownHooks,serve,serverResponse,url,warnOnMultipleRouterInstances}from"./stacks-router";export{cacheRequestQuery,clearCurrentRequest,getCurrentRequest,getTraceId,request,runWithRequest,setCurrentRequest,withTraceId}from"./request-context";export{defineMiddleware,Middleware}from"./middleware";export{appRouteRegistry,bundleMounts,DEFAULT_ROUTE_BUNDLE_FEATURES,DEFAULT_ROUTE_REGISTRY,listRootMountedAppRoutes,loadRoutes,mountedDefaultRouteBundles}from"./route-loader";export{clearTrackedQueries,createErrorResponse,createMiddlewareErrorResponse,createNotFoundResponse,createValidationErrorResponse,getQueryShapeCounts,trackQuery}from"./error-handler";export{listNamedRoutes,listRedirectRoutes,listRegisteredRoutes,routeParams}from"./stacks-router";export{DASHBOARD_ROUTE_GROUPS,dashboardGroupMiddleware,describeUnknownDashboardGroups,resolveDashboardAccess}from"./dashboard-access";export{isRouterAction,provideActions,provideMiddleware,resolveActionHandler,resolveActionValidations,wrapAction}from"./stacks-router";export{withRouteAdmission}from"./stacks-router";export{createTypedRouter}from"./typed-router";export{clearRouteModelBindings,defineRouteModelBinding,resolveRouteModel,routeModelBindings,setRouteModelFallback}from"./route-model-binding";export{isApiRequest,JSON_CONTENT_TYPE}from"./api-shape";export{rateLimit,rateLimitStatus,clearRateLimit,resetRateLimiters}from"./rate-limit";export{cacheRedisConnection,clientAddress,fallbackStorage,rateLimitScale,resetSharedRateLimitStorage,scaledLimit,sharedRateLimitStorage,trustedProxies,useRateLimitStorage}from"./security-settings";export{PathParamError,safePathParam,sanitizePathParam}from"./path-sanitize";export{checkApplicationHealth,runHealthProbes}from"./health";export{stream}from"./stacks-router";export{FORM_REFUSAL,formRefusalOf,refuse}from"./refuse";export{signedUrl,signUrl,verifySignedUrl,verifySignedUrlMiddleware}from"./signed-url";export{EncryptedSessionStore}from"./encrypted-session-store";export{createSessionStore,createStacksSessionStore,DatabaseSessionStore,FileSessionStore,MemorySessionStore,RedisSessionStore}from"./session-factory";
|
package/dist/refuse.d.ts
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { RefusalResponse } from '@stacksjs/actions';
|
|
2
|
+
/**
|
|
3
|
+
* A refusal: `{ error: message }` with `status` (and `errors` by field when
|
|
4
|
+
* one is named) for a caller that asked for data, and the person's page,
|
|
5
|
+
* saying `message`, for a browser form.
|
|
6
|
+
*/
|
|
7
|
+
export declare function refuse(message: string, options?: RefuseOptions): RefusalResponse;
|
|
8
|
+
/** What a refusal says, or undefined when `value` is not one. */
|
|
9
|
+
export declare function formRefusalOf(value: unknown): FormRefusal | undefined;
|
|
10
|
+
/**
|
|
11
|
+
* Where the router reads what a refusal says: on the `Response` an action
|
|
12
|
+
* returns, or on an error a middleware throws. A registered symbol, so code
|
|
13
|
+
* that must not load the router (the CSRF middleware) can set it too.
|
|
14
|
+
*/
|
|
15
|
+
export declare const FORM_REFUSAL: unique symbol;
|
|
16
|
+
export declare interface FormRefusal {
|
|
17
|
+
message: string
|
|
18
|
+
field?: string
|
|
19
|
+
status: number
|
|
20
|
+
}
|
|
21
|
+
export declare interface RefuseOptions {
|
|
22
|
+
status?: number
|
|
23
|
+
field?: string
|
|
24
|
+
}
|
package/dist/refuse.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const FORM_REFUSAL=Symbol.for("stacks.formRefusal");export function refuse(message,options={}){const status=options.status??422;if(!Number.isInteger(status)||status<400||status>599)throw new RangeError(`refuse() needs a 4xx or 5xx status, not ${status}`);const body={error:message};if(options.field)body.errors={[options.field]:[message]};const answer=Response.json(body,{status});const refusal={message,status,...options.field?{field:options.field}:{}};Object.defineProperty(answer,FORM_REFUSAL,{value:refusal});return answer}export function formRefusalOf(value){if(value===null||typeof value!=="object")return;const refusal=value[FORM_REFUSAL];return refusal&&typeof refusal.message==="string"&&typeof refusal.status==="number"?refusal:undefined}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { FileInfo } from '@stacksjs/bun-router';
|
|
2
|
-
import type { Collection } from '@stacksjs/types';
|
|
2
|
+
import type { AccessToken, Collection } from '@stacksjs/types';
|
|
3
|
+
import type { RequestTypeRegistry } from './index';
|
|
3
4
|
/**
|
|
4
5
|
* Stacks-specific marker fields attached to the request by the
|
|
5
6
|
* router itself and the framework's default middleware.
|
|
@@ -20,8 +21,8 @@ export declare interface StacksRequestMarkers {
|
|
|
20
21
|
_allInputCache?: unknown
|
|
21
22
|
_oldInput?: unknown
|
|
22
23
|
_validatedInput?: unknown
|
|
23
|
-
_authenticatedUser?:
|
|
24
|
-
_currentAccessToken?:
|
|
24
|
+
_authenticatedUser?: AuthenticatedUser
|
|
25
|
+
_currentAccessToken?: AccessToken
|
|
25
26
|
_bodyParsed?: boolean
|
|
26
27
|
_rawBodyContentType?: string
|
|
27
28
|
_responseHeaders?: Record<string, string>
|
|
@@ -65,14 +66,22 @@ export declare interface StacksRequestMacros {
|
|
|
65
66
|
getFiles?: (key: string) => FileInfo[]
|
|
66
67
|
hasFile?: (key: string) => boolean
|
|
67
68
|
allFiles?: () => Record<string, FileInfo | FileInfo[]>
|
|
68
|
-
user?: () => Promise<
|
|
69
|
-
userToken?: () => Promise<
|
|
69
|
+
user?: () => Promise<AuthenticatedUser | undefined>
|
|
70
|
+
userToken?: () => Promise<AccessToken | undefined>
|
|
70
71
|
tokenCan?: (ability: string) => Promise<boolean>
|
|
71
72
|
tokenCant?: (ability: string) => Promise<boolean>
|
|
72
73
|
can?: (ability: string, ...args: unknown[]) => Promise<boolean>
|
|
73
74
|
cannot?: (ability: string, ...args: unknown[]) => Promise<boolean>
|
|
74
75
|
authorize?: (ability: string, ...args: unknown[]) => Promise<void>
|
|
75
76
|
}
|
|
77
|
+
/**
|
|
78
|
+
* The signed-in user on a request: the type registered as
|
|
79
|
+
* `RequestTypeRegistry['user']` (see `./index`), or anything with an `id`
|
|
80
|
+
* when nothing is.
|
|
81
|
+
*/
|
|
82
|
+
export type AuthenticatedUser = RequestTypeRegistry extends { user: infer TUser extends { readonly id: number | string } }
|
|
83
|
+
? TUser
|
|
84
|
+
: { readonly id: number | string }
|
|
76
85
|
/**
|
|
77
86
|
* Union of Stacks markers + macros — useful as a single type alias for
|
|
78
87
|
* places that previously cast to `any`.
|
package/dist/stacks-router.d.ts
CHANGED
|
@@ -429,6 +429,8 @@ export declare interface RouterAction {
|
|
|
429
429
|
skipCsrf?: boolean
|
|
430
430
|
csrf?: boolean
|
|
431
431
|
apiResponse?: boolean
|
|
432
|
+
notice?: string | ((result: any, req: any) => string | null | undefined)
|
|
433
|
+
next?: string | ((result: any, req: any) => string | null | undefined)
|
|
432
434
|
model?: unknown
|
|
433
435
|
modelDefinition?: unknown
|
|
434
436
|
name?: string
|
package/dist/stacks-router.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
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
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
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,monitor:registry.get(key)?.monitor})}}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}const providedMiddleware=new Map;export function provideMiddleware(loaders){for(const[name,load]of Object.entries(loaders))providedMiddleware.set(name.endsWith(".ts")?name.slice(0,-3):name,load);middlewareCache=undefined}async function loadMiddleware(name){const cachedMiddleware=middlewareCache??=new Map;if(cachedMiddleware.has(name)){return cachedMiddleware.get(name)??null}const className=await resolveMiddlewareName(name);const provided=providedMiddleware.get(className)??providedMiddleware.get(name);if(provided){try{const middleware=await provided();const handler=middleware.default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' was provided by the build, but its module 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 the middleware '${name}' the build provided:`,err);return null}}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,monitor:()=>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},monitor(option){if(option!==false&&(typeof option!=="object"||option===null))throw new TypeError(`[Router] .monitor() on ${routeKey} takes false or an object with expect and path`);if(option!==false&&option.path!==undefined&&(typeof option.path!=="string"||!option.path.startsWith("/")))throw new TypeError(`[Router] .monitor() on ${routeKey}: path must start with a slash`);for(const state of states)state.monitor=option;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)}export async function resolveActionHandler(handlerPath){if(typeof handlerPath!=="string"||!/^Actions\/[\w/-]+(?:\.ts)?$/.test(handlerPath)||handlerPath.includes("Controller"))throw new Error(`[Router] '${String(handlerPath)}' does not name an action. An action is named by its path under app/, as in 'Actions/Orders/ShipOrderAction'.`);const handler=await resolveStringHandler(handlerPath);return(request)=>handler(request)}const namedActions=new Map;export async function resolveActionValidations(handlerPath){await resolveActionHandler(handlerPath);return namedActions.get(handlerPath)?.validations}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`);namedActions.set(handlerPath,action);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}`)}namedActions.set(handlerPath,action);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&¤tGroupApiResponse){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
|
|
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{formRefusalOf}from"./refuse";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){const[error,request]=args;const refusal=formRefusalOf(error);if(refusal&&isPageFormPost(request))return refusedByAction(request,refusal);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,monitor:registry.get(key)?.monitor})}}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}const providedMiddleware=new Map;export function provideMiddleware(loaders){for(const[name,load]of Object.entries(loaders))providedMiddleware.set(name.endsWith(".ts")?name.slice(0,-3):name,load);middlewareCache=undefined}async function loadMiddleware(name){const cachedMiddleware=middlewareCache??=new Map;if(cachedMiddleware.has(name)){return cachedMiddleware.get(name)??null}const className=await resolveMiddlewareName(name);const provided=providedMiddleware.get(className)??providedMiddleware.get(name);if(provided){try{const middleware=await provided();const handler=middleware.default??null;if(!handler||typeof handler.handle!=="function"){log.error(`[Router] Middleware '${name}' was provided by the build, but its module 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 the middleware '${name}' the build provided:`,err);return null}}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,monitor:()=>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},monitor(option){if(option!==false&&(typeof option!=="object"||option===null))throw new TypeError(`[Router] .monitor() on ${routeKey} takes false or an object with expect and path`);if(option!==false&&option.path!==undefined&&(typeof option.path!=="string"||!option.path.startsWith("/")))throw new TypeError(`[Router] .monitor() on ${routeKey}: path must start with a slash`);for(const state of states)state.monitor=option;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)}function formPage(req){const referer=req.headers.get("referer");if(!referer)return null;let page;try{page=new URL(referer)}catch{return null}const site=req.headers.get("sec-fetch-site");if(site){if(site!=="same-origin")return null}else{let host=req.headers.get("x-forwarded-host")?.split(",")[0]?.trim()||req.headers.get("host");if(!host){try{host=new URL(req.url).host}catch{return null}}if(host!==page.host)return null;const origin=req.headers.get("origin");if(origin&&origin!=="null"&&origin!==page.origin)return null}if(page.pathname.startsWith("//"))return null;return`${page.pathname}${page.search}`}function isPageFormPost(req){const method=req.method;if(method==="GET"||method==="HEAD"||req._forceJson===true)return false;if(isApiRequest(req))return false;const destination=req.headers.get("sec-fetch-dest");return!destination||destination==="document"||destination==="iframe"||destination==="frame"}function isLocalPagePath(path){if(!path.startsWith("/")||path.startsWith("//")||path.startsWith("/\\"))return false;if(/[\u0000-\u001F\u007F\s\\]/.test(path.slice(0,2)))return false;try{return new URL(path,"http://stacks.invalid").host==="stacks.invalid"}catch{return false}}function requestIsSecure(req){return req.headers.get("x-forwarded-proto")==="https"||req.url.startsWith("https:")}function backToPage(req,page,told){const flash=requireFormFlash();const mark=page.indexOf("?");const sealed=flash.sealFormFlash({path:mark===-1?page:page.slice(0,mark),errors:told.errors??{},old:told.old??{},notice:told.notice,formError:told.formError,expires:Date.now()+flash.FORM_FLASH_SECONDS*1000},flash.config.app?.key);if(!sealed)return null;return new Response(null,{status:303,headers:{location:page,"set-cookie":flash.formFlashCookie(sealed,requestIsSecure(req)),"cache-control":"no-store"}})}function escapeHtml(text){return text.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""")}function refusedFormDocument(errors,status=422){const messages=Object.values(errors).flat().map((message)=>`<li>${escapeHtml(message)}</li>`).join("");const html=`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>This form could not be submitted</title></head><body style="margin:0;font-family:system-ui,sans-serif;background:#fafafa;color:#171717"><main style="max-width:32rem;margin:15vh auto;padding:0 1.5rem"><h1 style="font-size:1.25rem;margin:0 0 .75rem">This form could not be submitted</h1><ul style="margin:0 0 1rem;padding-left:1.25rem;line-height:1.6">${messages}</ul><p style="margin:0;color:#525252">Go back to the form, correct it and send it again.</p></main></body></html>`;return new Response(html,{status,headers:{"content-type":"text/html; charset=utf-8","cache-control":"no-store"}})}function validationRefusal(req,errors){if(!isPageFormPost(req))return validationFailureResponse(errors);const page=formPage(req);if(!page)return refusedFormDocument(errors);return backToPage(req,page,{errors,old:postedInput(req)})??refusedFormDocument(errors)}function postedInput(req){try{return requireFormFlash().flashableInput(getAllInputFor(req))}catch{return{}}}function refusedByAction(req,refusal){const errors={[refusal.field??""]:[refusal.message]};const page=formPage(req);if(!page)return refusedFormDocument(errors,refusal.status);const told=refusal.field?{errors:{[refusal.field]:[refusal.message]}}:{formError:refusal.message};return backToPage(req,page,{...told,old:postedInput(req)})??refusedFormDocument(errors,refusal.status)}function hookAnswer(answer,req){const refusal=formRefusalOf(answer);return refusal&&isPageFormPost(req)?refusedByAction(req,refusal):answer}function answeredWithData(result){if(!(result instanceof Response))return!(result instanceof ReadableStream);if(result.status<200||result.status>299||result.headers.has("content-disposition"))return false;return result.status===204||JSON_CONTENT_TYPE.test(result.headers.get("content-type")??"")}function noticeDocument(notice){const text=escapeHtml(notice);const html=`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${text}</title></head><body style="margin:0;font-family:system-ui,sans-serif;background:#fafafa;color:#171717"><main style="max-width:32rem;margin:15vh auto;padding:0 1.5rem"><p role="status" style="font-size:1.25rem;margin:0">${text}</p></main></body></html>`;return new Response(html,{status:200,headers:{"content-type":"text/html; charset=utf-8","cache-control":"no-store"}})}function actionAnswer(result,req,action){if(!isPageFormPost(req))return formatResult(result,req);const refusal=formRefusalOf(result);if(refusal)return refusedByAction(req,refusal);if(!answeredWithData(result))return formatResult(result,req);const declared=typeof action.notice==="function"?action.notice(result,req):action.notice;const notice=typeof declared==="string"?declared.trim():"";const onward=typeof action.next==="function"?action.next(result,req):action.next;const page=(typeof onward==="string"&&isLocalPagePath(onward)?onward:null)??formPage(req);if(!page)return notice?noticeDocument(notice):formatResult(result,req);if(!notice)return new Response(null,{status:303,headers:{location:page,"cache-control":"no-store"}});return backToPage(req,page,{notice})??noticeDocument(notice)}let formFlashModule;function requireFormFlash(){return formFlashModule??=require("@stacksjs/config")}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)}export async function resolveActionHandler(handlerPath){if(typeof handlerPath!=="string"||!/^Actions\/[\w/-]+(?:\.ts)?$/.test(handlerPath)||handlerPath.includes("Controller"))throw new Error(`[Router] '${String(handlerPath)}' does not name an action. An action is named by its path under app/, as in 'Actions/Orders/ShipOrderAction'.`);const handler=await resolveStringHandler(handlerPath);return(request)=>handler(request)}const namedActions=new Map;export async function resolveActionValidations(handlerPath){await resolveActionHandler(handlerPath);return namedActions.get(handlerPath)?.validations}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`);namedActions.set(handlerPath,action);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}`)}namedActions.set(handlerPath,action);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;if(typeof action.next==="string"&&!isLocalPagePath(action.next))throw new Error(`Action '${action.name??handlerKey}' declares next: '${action.next}', which is not a path of this application. Write a path that starts with one '/'.`);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 validationRefusal(req,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 actionAnswer(value,req,action)}catch(error){return rethrowActionError(error)}},rethrowActionError):actionAnswer(result,req,action)}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 hookAnswer(auth,req);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 hookAnswer(pre,req)}const pendingResult=action.handle(req);const result=pendingResult instanceof Promise?await pendingResult:pendingResult;return actionAnswer(result,req,action)}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"||value==="on"){input[field]=true;coerced=true}else if(value==="false"||value==="0"){input[field]=false;coerced=true}}else if(validatorName==="array"){input[field]=value===""?[]:[value];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.scopes;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(validationRefusal(req,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&¤tGroupApiResponse){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
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
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.
|
|
5
|
+
"version": "0.75.613",
|
|
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.
|
|
72
|
-
"@stacksjs/collections": "0.75.
|
|
73
|
-
"@stacksjs/config": "0.75.
|
|
74
|
-
"@stacksjs/error-handling": "0.75.
|
|
75
|
-
"@stacksjs/logging": "0.75.
|
|
76
|
-
"@stacksjs/pagination": "0.75.
|
|
77
|
-
"@stacksjs/path": "0.75.
|
|
78
|
-
"@stacksjs/security": "0.75.
|
|
79
|
-
"@stacksjs/storage": "0.75.
|
|
71
|
+
"@stacksjs/cache": "0.75.613",
|
|
72
|
+
"@stacksjs/collections": "0.75.613",
|
|
73
|
+
"@stacksjs/config": "0.75.613",
|
|
74
|
+
"@stacksjs/error-handling": "0.75.613",
|
|
75
|
+
"@stacksjs/logging": "0.75.613",
|
|
76
|
+
"@stacksjs/pagination": "0.75.613",
|
|
77
|
+
"@stacksjs/path": "0.75.613",
|
|
78
|
+
"@stacksjs/security": "0.75.613",
|
|
79
|
+
"@stacksjs/storage": "0.75.613",
|
|
80
80
|
"ts-rate-limiter": "^0.4.10"
|
|
81
81
|
},
|
|
82
82
|
"devDependencies": {
|
|
83
|
-
"@stacksjs/actions": "0.75.
|
|
84
|
-
"@stacksjs/types": "0.75.
|
|
83
|
+
"@stacksjs/actions": "0.75.613",
|
|
84
|
+
"@stacksjs/types": "0.75.613",
|
|
85
85
|
"better-dx": "^0.2.39"
|
|
86
86
|
},
|
|
87
87
|
"peerDependencies": {
|
|
88
|
-
"@stacksjs/api": "0.75.
|
|
89
|
-
"@stacksjs/auth": "0.75.
|
|
90
|
-
"@stacksjs/database": "0.75.
|
|
91
|
-
"@stacksjs/validation": "0.75.
|
|
88
|
+
"@stacksjs/api": "0.75.613",
|
|
89
|
+
"@stacksjs/auth": "0.75.613",
|
|
90
|
+
"@stacksjs/database": "0.75.613",
|
|
91
|
+
"@stacksjs/validation": "0.75.613"
|
|
92
92
|
},
|
|
93
93
|
"peerDependenciesMeta": {
|
|
94
94
|
"@stacksjs/api": {
|