ShokupanRouter

Shokupan Router

A router for organizing and grouping routes with shared middleware and configuration.

Template

The shape of ctx.state for all routes in this router. Provides type safety for state management within the router’s middleware and handlers.

Examples

const router = new ShokupanRouter();
router.get('/users', (ctx) => ctx.json({ users: [] }));

app.mount('/api', router);
// Routes: GET /api/users

interface AuthState {
  userId: string;
  isAuthenticated: boolean;
}

class AuthRouter extends ShokupanRouter<AuthState> {
  constructor() {
    super();

    // Router middleware has typed state
    this.use((ctx, next) => {
      ctx.state.userId = 'user-123';
      ctx.state.isAuthenticated = true;
      return next();
    });

    this.get('/me', (ctx) => {
      // State is fully typed
      return ctx.json({ userId: ctx.state.userId });
    });
  }
}

app.mount('/auth', new AuthRouter());

const apiRouter = new ShokupanRouter();

// Router-level middleware
apiRouter.use(async (ctx, next) => {
  console.log(`API request: ${ctx.method} ${ctx.path}`);
  return next();
});

apiRouter.get('/status', (ctx) => ctx.json({ status: 'ok' }));
app.mount('/api', apiRouter);

Extended by

Type Parameters

T

T extends Record<string, any> = GlobalShokupanState

Constructors

Constructor

new ShokupanRouter<T>(config?): ShokupanRouter<T>

Defined in: src/router.ts:296

Parameters

config?

autoBackpressureFeedback?

boolean

Whether to enable automatic backpressure based on system CPU load.

Default

false

autoBackpressureLevel?

number

The CPU usage percentage threshold (0-100) at which to start rejecting requests.

fileAccessCheck?

(ctx, path) => boolean

Custom file access check for routes that use ctx.file(). Return true to allow access to the file, false to deny.

group?

string

hooks?

{ afterValidate?: (ctx, data) => void | Promise<void>; beforeValidate?: (ctx, data) => void | Promise<void>; onError?: (ctx, error) => void | Promise<void>; onReadTimeout?: (ctx) => void | Promise<void>; onRequestEnd?: (ctx) => void | Promise<void>; onRequestStart?: (ctx) => void | Promise<void>; onRequestTimeout?: (ctx) => void | Promise<void>; onResponseEnd?: (ctx, response) => void | Promise<void>; onResponseStart?: (ctx, response) => void | Promise<void>; onStop?: () => void | Promise<void>; onWriteTimeout?: (ctx) => void | Promise<void>; } | ({ afterValidate?: (ctx, data) => void | Promise<void>; beforeValidate?: (ctx, data) => void | Promise<void>; onError?: (ctx, error) => void | Promise<void>; onReadTimeout?: (ctx) => void | Promise<void>; onRequestEnd?: (ctx) => void | Promise<void>; onRequestStart?: (ctx) => void | Promise<void>; onRequestTimeout?: (ctx) => void | Promise<void>; onResponseEnd?: (ctx, response) => void | Promise<void>; onResponseStart?: (ctx, response) => void | Promise<void>; onStop?: () => void | Promise<void>; onWriteTimeout?: (ctx) => void | Promise<void>; } | undefined)[]

Hooks for this route/router.

name?

string

openapi?

{[key: `x-${string}`]: any; [key: string]: any; consumes?: (string | undefined)[]; deprecated?: boolean; description?: string; externalDocs?: {[key: string]: any; description?: string; url?: string; }; operationId?: string; parameters?: ({[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: string]: any; description?: string; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; } | {[key: string]: any; $ref?: string; allowEmptyValue?: boolean; collectionFormat?: string; default?: any; description?: string; enum?: any[]; exclusiveMaximum?: boolean; exclusiveMinimum?: boolean; format?: string; in?: ParameterLocation; items?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | { $ref?: … | …; collectionFormat?: … | …; default?: any; enum?: … | …; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { type?: string | undefined; format?: string | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | undefined; … 14 more …; $ref?: string | undefined; } | undefined; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; multipleOf?: … | …; pattern?: … | …; type?: … | …; uniqueItems?: … | … | …; }; maximum?: number; maxItems?: number; maxLength?: number; minimum?: number; minItems?: number; minLength?: number; multipleOf?: number; name?: string; pattern?: string; required?: boolean; type?: string; uniqueItems?: boolean; } | undefined)[]; produces?: (string | undefined)[]; responses?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; description?: string; examples?: {[key: string]: any; }; headers?: {[key: string]: … | …; }; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; } | undefined; default?: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; description?: string; examples?: {[key: string]: any; }; headers?: {[key: string]: … | …; }; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; }; }; schemes?: (string | undefined)[]; security?: ({[key: string]: (… | …)[] | undefined; } | undefined)[]; summary?: string; tags?: (string | undefined)[]; } | {[key: `x-${string}`]: any; [key: string]: any; callbacks?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: string]: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; delete?: … | …; description?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; servers?: … | …; summary?: … | …; trace?: … | …; } | undefined; } | undefined; }; deprecated?: boolean; description?: string; externalDocs?: { description?: string; url?: string; }; operationId?: string; parameters?: ({[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | { allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | undefined)[]; requestBody?: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | { content?: {[key: string]: { encoding?: … | …; example?: any; examples?: … | …; schema?: … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; content?: {[key: string]: … | …; }; description?: string; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; } | undefined; }; security?: ({[key: string]: (… | …)[] | undefined; } | undefined)[]; servers?: ({ description?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; summary?: string; tags?: (string | undefined)[]; } | {[key: string]: any; [key: number]: any; callbacks?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: string]: any; [key: number]: any; delete?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; servers?: … | …; trace?: … | …; } | undefined; } | undefined; }; parameters?: ({ allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | undefined)[]; requestBody?: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { content?: {[key: string]: { encoding?: … | …; example?: any; examples?: … | …; schema?: … | … | … | … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: any; [key: number]: any; content?: {[key: string]: … | …; }; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; } | undefined; }; servers?: ({ description?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; } | {[key: string]: any; [key: number]: any; callbacks?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: string]: any; [key: number]: any; additionalOperations?: … | …; delete?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; query?: … | …; trace?: … | …; } | undefined; } | undefined; }; parameters?: ({[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; valueOf?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; valueOf?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; items?: { [x: string]: any; [x: number]: any; summary?: string | undefined; description?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { …; } | { …; } | { …; } | un…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; items?: { [x: string]: any; [x: number]: any; summary?: string | undefined; description?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { …; } | { …; } | { …; } | un…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | undefined)[]; requestBody?: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { content?: {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | { encoding?: … | …; example?: any; examples?: … | …; itemEncoding?: … | …; itemSchema?: … | … | … | … | … | … | …; prefixEncoding?: … | …; schema?: … | … | … | … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: any; [key: number]: any; content?: {[key: string]: … | … | …; }; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; summary?: string; } | undefined; }; servers?: ({ description?: string; name?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; }

renderer?

JSXRenderer

Custom renderer for this route.

requestTimeout?

number

Timeout for this specific route (milliseconds).

Returns

ShokupanRouter<T>

Properties

[$childControllers]

[$childControllers]: ShokupanController[] = []

Defined in: src/router.ts:101

[$childRouters]

[$childRouters]: ShokupanRouter<T>[] = []

Defined in: src/router.ts:100

[$mountPath]

[$mountPath]: string = "/"

Defined in: src/router.ts:97

[$routes]

[$routes]: ShokupanRoute[] = []

Defined in: src/router.ts:146

config?

readonly optional config: object

Defined in: src/router.ts:297

autoBackpressureFeedback?

optional autoBackpressureFeedback: boolean

Whether to enable automatic backpressure based on system CPU load.

Default

false

autoBackpressureLevel?

optional autoBackpressureLevel: number

The CPU usage percentage threshold (0-100) at which to start rejecting requests.

fileAccessCheck()?

optional fileAccessCheck: (ctx, path) => boolean

Custom file access check for routes that use ctx.file(). Return true to allow access to the file, false to deny.

Parameters

ctx

ShokupanContext

path

string

Returns

boolean

group?

optional group: string

hooks?

optional hooks: { afterValidate?: (ctx, data) => void | Promise<void>; beforeValidate?: (ctx, data) => void | Promise<void>; onError?: (ctx, error) => void | Promise<void>; onReadTimeout?: (ctx) => void | Promise<void>; onRequestEnd?: (ctx) => void | Promise<void>; onRequestStart?: (ctx) => void | Promise<void>; onRequestTimeout?: (ctx) => void | Promise<void>; onResponseEnd?: (ctx, response) => void | Promise<void>; onResponseStart?: (ctx, response) => void | Promise<void>; onStop?: () => void | Promise<void>; onWriteTimeout?: (ctx) => void | Promise<void>; } | ({ afterValidate?: (ctx, data) => void | Promise<void>; beforeValidate?: (ctx, data) => void | Promise<void>; onError?: (ctx, error) => void | Promise<void>; onReadTimeout?: (ctx) => void | Promise<void>; onRequestEnd?: (ctx) => void | Promise<void>; onRequestStart?: (ctx) => void | Promise<void>; onRequestTimeout?: (ctx) => void | Promise<void>; onResponseEnd?: (ctx, response) => void | Promise<void>; onResponseStart?: (ctx, response) => void | Promise<void>; onStop?: () => void | Promise<void>; onWriteTimeout?: (ctx) => void | Promise<void>; } | undefined)[]

Hooks for this route/router.

name?

optional name: string

openapi?

optional openapi: {[key: `x-${string}`]: any; [key: string]: any; consumes?: (string | undefined)[]; deprecated?: boolean; description?: string; externalDocs?: {[key: string]: any; description?: string; url?: string; }; operationId?: string; parameters?: ({[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: string]: any; description?: string; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; } | {[key: string]: any; $ref?: string; allowEmptyValue?: boolean; collectionFormat?: string; default?: any; description?: string; enum?: any[]; exclusiveMaximum?: boolean; exclusiveMinimum?: boolean; format?: string; in?: ParameterLocation; items?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | { $ref?: … | …; collectionFormat?: … | …; default?: any; enum?: … | …; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { type?: string | undefined; format?: string | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | undefined; … 14 more …; $ref?: string | undefined; } | undefined; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; multipleOf?: … | …; pattern?: … | …; type?: … | …; uniqueItems?: … | … | …; }; maximum?: number; maxItems?: number; maxLength?: number; minimum?: number; minItems?: number; minLength?: number; multipleOf?: number; name?: string; pattern?: string; required?: boolean; type?: string; uniqueItems?: boolean; } | undefined)[]; produces?: (string | undefined)[]; responses?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; description?: string; examples?: {[key: string]: any; }; headers?: {[key: string]: … | …; }; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; } | undefined; default?: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; description?: string; examples?: {[key: string]: any; }; headers?: {[key: string]: … | …; }; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: string]: any; [key: `x-${(...)}`]: any; $ref?: … | …; $schema?: … | …; additionalItems?: … | … | … | …; additionalProperties?: … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; definitions?: … | …; dependencies?: … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; id?: … | …; items?: … | … | … | … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | … | …; uniqueItems?: … | … | …; xml?: … | …; }; }; }; schemes?: (string | undefined)[]; security?: ({[key: string]: (… | …)[] | undefined; } | undefined)[]; summary?: string; tags?: (string | undefined)[]; } | {[key: `x-${string}`]: any; [key: string]: any; callbacks?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: string]: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; delete?: … | …; description?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; servers?: … | …; summary?: … | …; trace?: … | …; } | undefined; } | undefined; }; deprecated?: boolean; description?: string; externalDocs?: { description?: string; url?: string; }; operationId?: string; parameters?: ({[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | { allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | undefined)[]; requestBody?: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | { content?: {[key: string]: { encoding?: … | …; example?: any; examples?: … | …; schema?: … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: `x-${string}`]: any; [key: string]: any; $ref?: string; } | {[key: `x-${string}`]: any; [key: string]: any; content?: {[key: string]: … | …; }; description?: string; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; } | undefined; }; security?: ({[key: string]: (… | …)[] | undefined; } | undefined)[]; servers?: ({ description?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; summary?: string; tags?: (string | undefined)[]; } | {[key: string]: any; [key: number]: any; callbacks?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: string]: any; [key: number]: any; delete?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; servers?: … | …; trace?: … | …; } | undefined; } | undefined; }; parameters?: ({ allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: `x-${(...)}`]: any; [key: string]: any; $ref?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; additionalProperties?: … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; exclusiveMaximum?: … | … | …; exclusiveMinimum?: … | … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; type?: “array” | undefined; items?: { [x: `x-${string}`]: any; [x: string]: any; $ref?: string | undefined; } | … | { …; } | undefined; … 33 more …; deprecated?: boolean | undefined; } | {…; nullable?: … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | undefined)[]; requestBody?: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { content?: {[key: string]: { encoding?: … | …; example?: any; examples?: … | …; schema?: … | … | … | … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: any; [key: number]: any; content?: {[key: string]: … | …; }; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; } | undefined; }; servers?: ({ description?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; } | {[key: string]: any; [key: number]: any; callbacks?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: string]: any; [key: number]: any; additionalOperations?: … | …; delete?: … | …; get?: … | …; head?: … | …; options?: … | …; parameters?: … | …; patch?: … | …; post?: … | …; put?: … | …; query?: … | …; trace?: … | …; } | undefined; } | undefined; }; parameters?: ({[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { allowEmptyValue?: boolean; allowReserved?: boolean; content?: {[key: string]: … | …; }; deprecated?: boolean; description?: string; example?: any; examples?: {[key: string]: … | … | …; }; explode?: boolean; in?: ParameterLocation; name?: string; required?: boolean; schema?: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; valueOf?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; valueOf?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; items?: { [x: string]: any; [x: number]: any; summary?: string | undefined; description?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { …; } | { …; } | { …; } | un…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; } | {[key: `x-${(...)}`]: any; [key: string]: any; $schema?: … | …; additionalProperties?: … | … | … | … | … | … | … | … | …; allOf?: … | …; anyOf?: … | …; const?: any; contentMediaType?: … | …; default?: any; deprecated?: … | … | …; description?: … | …; discriminator?: … | …; enum?: … | …; example?: any; examples?: … | …; exclusiveMaximum?: … | …; exclusiveMinimum?: … | …; externalDocs?: … | …; format?: … | …; items?: { [x: string]: any; [x: number]: any; summary?: string | undefined; description?: string | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { [x: `x-${string}`]: any; [x: string]: any; valueOf?: (() => boolean) | undefined; } | { …; } | { …; } | { …; } | un…; maximum?: … | …; maxItems?: … | …; maxLength?: … | …; maxProperties?: … | …; minimum?: … | …; minItems?: … | …; minLength?: … | …; minProperties?: … | …; multipleOf?: … | …; not?: … | … | … | … | … | … | …; oneOf?: … | …; pattern?: … | …; patternProperties?: … | …; properties?: … | …; readOnly?: … | … | …; required?: … | …; title?: … | …; type?: … | …; uniqueItems?: … | … | …; writeOnly?: … | … | …; xml?: … | …; }; style?: ParameterStyle; } | undefined)[]; requestBody?: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | { content?: {[key: string]: {[key: string]: any; [key: number]: any; description?: … | …; summary?: … | …; } | { encoding?: … | …; example?: any; examples?: … | …; itemEncoding?: … | …; itemSchema?: … | … | … | … | … | … | …; prefixEncoding?: … | …; schema?: … | … | … | … | … | … | …; } | undefined; }; description?: string; required?: boolean; }; responses?: {[key: string]: {[key: string]: any; [key: number]: any; description?: string; summary?: string; } | {[key: string]: any; [key: number]: any; content?: {[key: string]: … | … | …; }; headers?: {[key: string]: … | … | …; }; links?: {[key: string]: … | … | …; }; summary?: string; } | undefined; }; servers?: ({ description?: string; name?: string; url?: string; variables?: {[key: string]: … | …; }; } | undefined)[]; }

renderer?

optional renderer: JSXRenderer

Custom renderer for this route.

requestTimeout?

optional requestTimeout: number

Timeout for this specific route (milliseconds).

mcpProtocol

mcpProtocol: McpProtocol

Defined in: src/router.ts:150

metadata?

optional metadata: RouteMetadata

Defined in: src/router.ts:148

middleware

middleware: Middleware[] = []

Defined in: src/router.ts:133

requestTimeout?

optional requestTimeout: number

Defined in: src/router.ts:126

Accessors

hasAfterValidateHook

Get Signature

get hasAfterValidateHook(): boolean

Defined in: src/router.ts:124

Returns

boolean

hasBeforeValidateHook

Get Signature

get hasBeforeValidateHook(): boolean

Defined in: src/router.ts:123

Returns

boolean

hasOnErrorHook

Get Signature

get hasOnErrorHook(): boolean

Defined in: src/router.ts:119

Returns

boolean

hasOnReadTimeoutHook

Get Signature

get hasOnReadTimeoutHook(): boolean

Defined in: src/router.ts:121

Returns

boolean

hasOnRequestEndHook

Get Signature

get hasOnRequestEndHook(): boolean

Defined in: src/router.ts:117

Returns

boolean

hasOnRequestStartHook

Get Signature

get hasOnRequestStartHook(): boolean

Defined in: src/router.ts:116

Returns

boolean

hasOnRequestTimeoutHook

Get Signature

get hasOnRequestTimeoutHook(): boolean

Defined in: src/router.ts:120

Returns

boolean

hasOnResponseEndHook

Get Signature

get hasOnResponseEndHook(): boolean

Defined in: src/router.ts:115

Returns

boolean

hasOnResponseStartHook

Get Signature

get hasOnResponseStartHook(): boolean

Defined in: src/router.ts:118

Returns

boolean

hasOnStopHook

Get Signature

get hasOnStopHook(): boolean

Defined in: src/router.ts:114

Returns

boolean

hasOnWriteTimeoutHook

Get Signature

get hasOnWriteTimeoutHook(): boolean

Defined in: src/router.ts:122

Returns

boolean

logger

Get Signature

get logger(): Logger | undefined

Defined in: src/router.ts:142

Returns

Logger | undefined

registry

Get Signature

get registry(): object

Defined in: src/router.ts:208

Returns

object

controllers

controllers: object[]

events

events: object[]

metadata

metadata: RouteMetadata | undefined

middleware

middleware: object[]

routers

routers: object[]

routes

routes: object[]

root

Get Signature

get root(): Shokupan<any>

Defined in: src/router.ts:138

Returns

Shokupan<any>

rootConfig

Get Signature

get rootConfig(): Partial<{ adapter?: ServerAdapter | "bun" | "node" | "wintercg"; aiPlugin?: { api?: { is_user_authenticated?: boolean; type: "openapi"; url?: string; }; auth?: {[key: string]: any; type: "none" | "service_http" | "user_http" | "oauth"; }; contact_email?: string; description_for_human?: string; description_for_model?: string; enabled?: boolean; legal_info_url?: string; logo_url?: string; name_for_human?: string; name_for_model?: string; }; allowChunkedBody?: boolean; allowedStaticFilePaths?: string[]; apiCatalog?: { enabled?: boolean; versions?: object[]; }; astAnalysisTimeout?: number; astFilePath?: string; autoBackpressureFeedback?: boolean; autoBackpressureLevel?: number; blockOnAsyncApiGen: boolean; blockOnOpenApiGen: boolean; datastore?: { adapter: "surreal" | "sqlite" | "level"; options?: any; }; defaultResponseTransformer?: string; defaultSecurityHeaders?: any; development: boolean; disableBodyParsing?: boolean; enableAbortController?: boolean; enableAsyncApiGen: boolean; enableAsyncAstScanning?: boolean; enableAsyncLocalStorage: boolean; enableAutoContentNegotiation?: boolean; enableHTTPBridge?: boolean; enableMiddlewareTracking: boolean; enableOpenApiGen: boolean; enablePromiseMonkeypatch: boolean; enableTracing?: boolean; enableWebSocketTracking?: boolean; fileAccessCheck?: (ctx, path) => boolean; fileSystem?: FileSystemAdapter; hooks: ShokupanHooks<Record<string, any>> | ShokupanHooks<Record<string, any>>[]; hostname: string; httpLogger: (ctx) => void; ide?: string; idGenerator?: () => string; jsonParser?: "native" | "parse-json" | "secure-json-parse"; logger: Logger; maxBodySize?: number; middlewareTrackingMaxCapacity?: number; middlewareTrackingTTL?: number; port: number; queryParserMode?: "strict" | "extended" | "simple"; readTimeout: number; renderer: JSXRenderer; requestTimeout: number; reusePort: boolean; tls: {[key: string]: any; cert: string; key: string; }; validateStatusCodes: boolean; websocketErrorHandler?: (err, ctx) => void | Promise<void>; writeTimeout: number; }>

Defined in: src/router.ts:135

Returns

Partial<{ adapter?: ServerAdapter | "bun" | "node" | "wintercg"; aiPlugin?: { api?: { is_user_authenticated?: boolean; type: "openapi"; url?: string; }; auth?: {[key: string]: any; type: "none" | "service_http" | "user_http" | "oauth"; }; contact_email?: string; description_for_human?: string; description_for_model?: string; enabled?: boolean; legal_info_url?: string; logo_url?: string; name_for_human?: string; name_for_model?: string; }; allowChunkedBody?: boolean; allowedStaticFilePaths?: string[]; apiCatalog?: { enabled?: boolean; versions?: object[]; }; astAnalysisTimeout?: number; astFilePath?: string; autoBackpressureFeedback?: boolean; autoBackpressureLevel?: number; blockOnAsyncApiGen: boolean; blockOnOpenApiGen: boolean; datastore?: { adapter: "surreal" | "sqlite" | "level"; options?: any; }; defaultResponseTransformer?: string; defaultSecurityHeaders?: any; development: boolean; disableBodyParsing?: boolean; enableAbortController?: boolean; enableAsyncApiGen: boolean; enableAsyncAstScanning?: boolean; enableAsyncLocalStorage: boolean; enableAutoContentNegotiation?: boolean; enableHTTPBridge?: boolean; enableMiddlewareTracking: boolean; enableOpenApiGen: boolean; enablePromiseMonkeypatch: boolean; enableTracing?: boolean; enableWebSocketTracking?: boolean; fileAccessCheck?: (ctx, path) => boolean; fileSystem?: FileSystemAdapter; hooks: ShokupanHooks<Record<string, any>> | ShokupanHooks<Record<string, any>>[]; hostname: string; httpLogger: (ctx) => void; ide?: string; idGenerator?: () => string; jsonParser?: "native" | "parse-json" | "secure-json-parse"; logger: Logger; maxBodySize?: number; middlewareTrackingMaxCapacity?: number; middlewareTrackingTTL?: number; port: number; queryParserMode?: "strict" | "extended" | "simple"; readTimeout: number; renderer: JSXRenderer; requestTimeout: number; reusePort: boolean; tls: {[key: string]: any; cert: string; key: string; }; validateStatusCodes: boolean; websocketErrorHandler?: (err, ctx) => void | Promise<void>; writeTimeout: number; }>

Methods

add()

add(arg): ShokupanRouter<T>

Defined in: src/router.ts:1160

Adds a route to the router.

Parameters

arg

Route configuration object

controller?

any

Controller for the route

group?

string

Group for the route

handler

ShokupanHandler<T>

Route handler function

metadata?

{ file: string; line: number; }

metadata.file

string

metadata.line

number

method

Method

HTTP method

middleware?

Middleware[]

path

string

URL path

regex?

RegExp

Custom regex for path matching

renderer?

JSXRenderer

JSX renderer for the route

requestTimeout?

number

Timeout for this route in milliseconds

spec?

MethodAPISpec

OpenAPI specification for the route

Returns

ShokupanRouter<T>

bindController()

bindController(controller): void

Defined in: src/router.ts:402

Registers a controller instance to the router.

Parameters

controller

any

Returns

void

delete()

Call Signature

delete<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1368

Adds a DELETE route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

delete<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1376

Adds a DELETE route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

find()

find(method, path): { handler: ShokupanHandler<T>; params: Record<string, string>; route?: any; } | null

Defined in: src/router.ts:1065

Find a route matching the given method and path. Wraps handler with router middleware if present.

Parameters

method

string

HTTP method

path

string

Request path

Returns

{ handler: ShokupanHandler<T>; params: Record<string, string>; route?: any; } | null

Route handler and parameters if found, otherwise null

findEvent()

findEvent(name): ShokupanHandler<T>[] | null

Defined in: src/router.ts:383

Finds an event handler(s) by name.

Parameters

name

string

Returns

ShokupanHandler<T>[] | null

generateApiSpec()

generateApiSpec(options): Promise<any>

Defined in: src/router.ts:1652

Generates an OpenAPI 3.1 Document by recursing through the router and its descendants. Now includes runtime analysis of handler functions to infer request/response types.

Parameters

options

OpenAPIOptions = {}

Returns

Promise<any>

get()

Call Signature

get<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1308

Adds a GET route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

get<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1316

Adds a GET route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

getEventHandlers()

getEventHandlers(): Map<string, ShokupanHandler<T>[]>

Defined in: src/router.ts:409

Returns all registered event handlers.

Returns

Map<string, ShokupanHandler<T>[]>

getRoutes()

getRoutes(): object[]

Defined in: src/router.ts:801

Returns all routes attached to this router and its descendants.

Returns

object[]

guard()

Call Signature

guard(handler): void

Defined in: src/router.ts:1509

Adds a guard to the router that applies to all routes added after this point. Guards must return true or call ctx.next() to allow the request to continue.

Parameters

handler

ShokupanHandler<T>

Guard handler function

Returns

void

Call Signature

guard(spec, handler): void

Defined in: src/router.ts:1517

Adds a guard to the router that applies to all routes added after this point. Guards must return true or call ctx.next() to allow the request to continue.

Parameters

spec

GuardAPISpec

OpenAPI specification for the guard

handler

ShokupanHandler<T>

Guard handler function

Returns

void

hasHooks()

hasHooks(name): boolean

Defined in: src/router.ts:1657

Parameters

name

keyof ShokupanHooks<any>

Returns

boolean

head()

Call Signature

head<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1428

Adds a HEAD route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

head<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1436

Adds a HEAD route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

hook()

hook(name, handler): ShokupanRouter<T>

Defined in: src/router.ts:317

Registers a lifecycle hook dynamically.

Parameters

name

keyof ShokupanHooks<any>

handler

Function

Returns

ShokupanRouter<T>

internalRequest()

internalRequest(arg): Promise<Response | undefined>

Defined in: src/router.ts:833

Makes an internal request through this router’s full routing pipeline. This is useful for calling other routes internally and supports streaming responses.

Parameters

arg

string | { body?: any; headers?: HeadersInit; method?: Method; path: string; }

Returns

Promise<Response | undefined>

The raw Response object.

mount()

mount(prefix, controller): ShokupanRouter<T>

Defined in: src/router.ts:423

Mounts a controller instance or WebSocket router to a path prefix.

Controller can be a convention router, WebSocket router, or an arbitrary class.

Routes are derived from method names:

get(ctx) -> GET /prefix/
getUsers(ctx) -> GET /prefix/users
postCreate(ctx) -> POST /prefix/create

Parameters

prefix

string

controller

Record<string, any> | ShokupanRouter<T> | ShokupanRouter<GlobalShokupanState> | ShokupanController | ShokupanController<T>

Returns

ShokupanRouter<T>

options()

Call Signature

options<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1408

Adds a OPTIONS route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

options<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1416

Adds a OPTIONS route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

patch()

Call Signature

patch<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1388

Adds a PATCH route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

patch<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1396

Adds a PATCH route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

post()

Call Signature

post<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1328

Adds a POST route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

post<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1336

Adds a POST route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

prompt()

prompt(name, args, handler): ShokupanRouter<T>

Defined in: src/router.ts:359

Registers an MCP Prompt.

Parameters

name

string

args

object[] | undefined

handler

Function

Returns

ShokupanRouter<T>

put()

Call Signature

put<Path>(path, handler, …handlers): this

Defined in: src/router.ts:1348

Adds a PUT route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

Call Signature

put<Path>(path, spec, handler, …handlers): this

Defined in: src/router.ts:1356

Adds a PUT route to the router.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path

spec

MethodAPISpec

OpenAPI specification for the route

handler

ShokupanHandler<T, RouteParams<Path>>

handlers

…ShokupanHandler<T, RouteParams<Path>>[]

Route handler functions

Returns

this

resource()

resource(uri, options, handler): ShokupanRouter<T>

Defined in: src/router.ts:371

Registers an MCP Resource.

Parameters

uri

string

options

description?

string

mimeType?

string

name?

string

handler

Function

Returns

ShokupanRouter<T>

runHooks()

runHooks(name, …args): void | Promise<void[]>

Defined in: src/router.ts:1708

Parameters

name

keyof ShokupanHooks<any>

args

…any[]

Returns

void | Promise<void[]>

runOnStopHooks()

runOnStopHooks(app): Promise<void>

Defined in: src/router.ts:1749

Parameters

app

Shokupan<any>

Returns

Promise<void>

socket()

socket<Path>(path, handler): this

Defined in: src/router.ts:1469

Adds a WebSocket route that handles its own upgrade logic.

Unless you need to handle the upgrade manually, you should use a ShokupanWebsocketRouter or WebsocketController instead.

Routes registered with .socket() will NOT be automatically upgraded by Shokupan’s WebSocket handling. You must implement all event handlers manually. You have been warned.

Type Parameters

Path

Path extends string

Parameters

path

Path

URL path for the WebSocket endpoint

handler

ShokupanHandler<T, RouteParams<Path>>

Route handler that will manually handle the upgrade

Returns

this

Example

router.socket("/ws", (ctx) => {
  const success = ctx.upgrade({
    data: {
      handler: {
        open: (ws) => console.log("Connected"),
        message: (ws, msg) => ws.send(msg),
        close: (ws) => console.log("Disconnected")
      }
    }
  });
  if (!success) return ctx.text("Upgrade failed", 400);
});