shokupan 0.4.5 → 0.6.0

package/dist/{server-adapter-BWrEJbKL.js → server-adapter-0xH174zz.js}

@@ -13,7 +13,9 @@ function createHttpServer() {
             req.on("end", () => controller.close());
             req.on("error", (err) => controller.error(err));
           }
-        })
+        }),
+        // Required for Node.js undici when sending a body
+        duplex: "half"
       });
       const response = await options.fetch(request, fauxServer);
       res.statusCode = response.status;
@@ -61,4 +63,4 @@ function createHttpServer() {
 export {
   createHttpServer
 };
-//# sourceMappingURL=server-adapter-BWrEJbKL.js.map
+//# sourceMappingURL=server-adapter-0xH174zz.js.map

package/dist/server-adapter-0xH174zz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-adapter-0xH174zz.js","sources":["../src/plugins/server-adapter.ts"],"sourcesContent":["import type { Server } from \"bun\";\nimport * as http from \"node:http\";\nimport * as https from \"node:https\";\nimport type { ServerFactory } from \"../types\";\n\n/**\n * Creates a server factory that uses the standard Node.js `http` module.\n * @returns A ServerFactory compatible with Shokupan.\n */\nexport function createHttpServer(): ServerFactory {\n    return async (options: any): Promise<Server> => {\n        const server = http.createServer(async (req, res) => {\n            const url = new URL(req.url!, `http://${req.headers.host}`);\n            const request = new Request(url.toString(), {\n                method: req.method,\n                headers: req.headers as any,\n                body: ['GET', 'HEAD'].includes(req.method!) ? undefined : new ReadableStream({\n                    start(controller) {\n                        req.on('data', chunk => controller.enqueue(chunk));\n                        req.on('end', () => controller.close());\n                        req.on('error', err => controller.error(err));\n                    }\n                }) as any,\n                // Required for Node.js undici when sending a body\n                duplex: 'half'\n            } as any);\n\n            const response = await options.fetch(request, fauxServer);\n\n            res.statusCode = response.status;\n            response.headers.forEach((v, k) => res.setHeader(k, v));\n\n            if (response.body) {\n                // Optimize: Use arrayBuffer for direct conversion instead of async iteration\n                const buffer = await response.arrayBuffer();\n                res.end(Buffer.from(buffer));\n            } else {\n                res.end();\n            }\n        });\n\n        const fauxServer: Server = {\n            stop: () => {\n                server.close();\n                return Promise.resolve(); // Bun.Server stop usually returns void but in type definition it might vary.\n            },\n            upgrade(req, options) {\n                return false;\n            },\n            reload(options) {\n                return fauxServer as any;\n            },\n            get port() {\n                const addr = server.address();\n                if (typeof addr === 'object' && addr !== null) {\n                    return addr.port;\n                }\n                return options.port;\n            },\n            hostname: options.hostname,\n            development: options.development,\n            pendingRequests: 0,\n            requestIP: (req) => null,\n            publish: () => 0,\n            subscriberCount: () => 0,\n            url: new URL(`http://${options.hostname}:${options.port}`)\n        } as unknown as Server;\n\n        return new Promise((resolve) => {\n            server.listen(options.port, options.hostname, () => {\n                resolve(fauxServer);\n            });\n        });\n    };\n}\n\n/**\n * Creates a server factory that uses the standard Node.js `https` module.\n * @param sslOptions - Node.js HTTPS options (key, cert, etc.)\n * @returns A ServerFactory compatible with Shokupan.\n */\nexport function createHttpsServer(sslOptions: https.ServerOptions): ServerFactory {\n    return async (options: any): Promise<Server> => {\n        const server = https.createServer(sslOptions, async (req, res) => {\n            const url = new URL(req.url!, `https://${req.headers.host}`);\n            const request = new Request(url.toString(), {\n                method: req.method,\n                headers: req.headers as any,\n                body: ['GET', 'HEAD'].includes(req.method!) ? undefined : new ReadableStream({\n                    start(controller) {\n                        req.on('data', chunk => controller.enqueue(chunk));\n                        req.on('end', () => controller.close());\n                        req.on('error', err => controller.error(err));\n                    }\n                }) as any,\n                // Required for Node.js undici when sending a body\n                duplex: 'half'\n            } as any);\n\n            const response = await options.fetch(request, fauxServer);\n\n            res.statusCode = response.status;\n            response.headers.forEach((v, k) => res.setHeader(k, v));\n\n            if (response.body) {\n                // Optimize: Use arrayBuffer for direct conversion instead of async iteration\n                const buffer = await response.arrayBuffer();\n                res.end(Buffer.from(buffer));\n            } else {\n                res.end();\n            }\n        });\n\n        const fauxServer: Server = {\n            stop: () => {\n                server.close();\n            },\n            upgrade(req, options) {\n                return false;\n            },\n            reload(options) {\n                return fauxServer as any;\n            },\n            get port() {\n                const addr = server.address();\n                if (typeof addr === 'object' && addr !== null) {\n                    return addr.port;\n                }\n                return options.port;\n            },\n            hostname: options.hostname,\n            development: options.development,\n            pendingRequests: 0,\n            requestIP: (req) => null,\n            publish: () => 0,\n            subscriberCount: () => 0,\n            url: new URL(`https://${options.hostname}:${options.port}`)\n        } as unknown as Server;\n\n        return new Promise((resolve) => {\n            server.listen(options.port, options.hostname, () => {\n                resolve(fauxServer);\n            });\n        });\n    };\n}\n"],"names":["options"],"mappings":";;AASO,SAAS,mBAAkC;AAC9C,SAAO,OAAO,YAAkC;AAC5C,UAAM,SAAS,KAAK,aAAa,OAAO,KAAK,QAAQ;AACjD,YAAM,MAAM,IAAI,IAAI,IAAI,KAAM,UAAU,IAAI,QAAQ,IAAI,EAAE;AAC1D,YAAM,UAAU,IAAI,QAAQ,IAAI,YAAY;AAAA,QACxC,QAAQ,IAAI;AAAA,QACZ,SAAS,IAAI;AAAA,QACb,MAAM,CAAC,OAAO,MAAM,EAAE,SAAS,IAAI,MAAO,IAAI,SAAY,IAAI,eAAe;AAAA,UACzE,MAAM,YAAY;AACd,gBAAI,GAAG,QAAQ,CAAA,UAAS,WAAW,QAAQ,KAAK,CAAC;AACjD,gBAAI,GAAG,OAAO,MAAM,WAAW,OAAO;AACtC,gBAAI,GAAG,SAAS,CAAA,QAAO,WAAW,MAAM,GAAG,CAAC;AAAA,UAChD;AAAA,QAAA,CACH;AAAA;AAAA,QAED,QAAQ;AAAA,MAAA,CACJ;AAER,YAAM,WAAW,MAAM,QAAQ,MAAM,SAAS,UAAU;AAExD,UAAI,aAAa,SAAS;AAC1B,eAAS,QAAQ,QAAQ,CAAC,GAAG,MAAM,IAAI,UAAU,GAAG,CAAC,CAAC;AAEtD,UAAI,SAAS,MAAM;AAEf,cAAM,SAAS,MAAM,SAAS,YAAA;AAC9B,YAAI,IAAI,OAAO,KAAK,MAAM,CAAC;AAAA,MAC/B,OAAO;AACH,YAAI,IAAA;AAAA,MACR;AAAA,IACJ,CAAC;AAED,UAAM,aAAqB;AAAA,MACvB,MAAM,MAAM;AACR,eAAO,MAAA;AACP,eAAO,QAAQ,QAAA;AAAA,MACnB;AAAA,MACA,QAAQ,KAAKA,UAAS;AAClB,eAAO;AAAA,MACX;AAAA,MACA,OAAOA,UAAS;AACZ,eAAO;AAAA,MACX;AAAA,MACA,IAAI,OAAO;AACP,cAAM,OAAO,OAAO,QAAA;AACpB,YAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAC3C,iBAAO,KAAK;AAAA,QAChB;AACA,eAAO,QAAQ;AAAA,MACnB;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,aAAa,QAAQ;AAAA,MACrB,iBAAiB;AAAA,MACjB,WAAW,CAAC,QAAQ;AAAA,MACpB,SAAS,MAAM;AAAA,MACf,iBAAiB,MAAM;AAAA,MACvB,KAAK,IAAI,IAAI,UAAU,QAAQ,QAAQ,IAAI,QAAQ,IAAI,EAAE;AAAA,IAAA;AAG7D,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC5B,aAAO,OAAO,QAAQ,MAAM,QAAQ,UAAU,MAAM;AAChD,gBAAQ,UAAU;AAAA,MACtB,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AACJ;"}

package/dist/{server-adapter-fVKP60e0.cjs → server-adapter-DFhwlK8e.cjs}

@@ -32,7 +32,9 @@ function createHttpServer() {
             req.on("end", () => controller.close());
             req.on("error", (err) => controller.error(err));
           }
-        })
+        }),
+        // Required for Node.js undici when sending a body
+        duplex: "half"
       });
       const response = await options.fetch(request, fauxServer);
       res.statusCode = response.status;
@@ -78,4 +80,4 @@ function createHttpServer() {
   };
 }
 exports.createHttpServer = createHttpServer;
-//# sourceMappingURL=server-adapter-fVKP60e0.cjs.map
+//# sourceMappingURL=server-adapter-DFhwlK8e.cjs.map

package/dist/server-adapter-DFhwlK8e.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-adapter-DFhwlK8e.cjs","sources":["../src/plugins/server-adapter.ts"],"sourcesContent":["import type { Server } from \"bun\";\nimport * as http from \"node:http\";\nimport * as https from \"node:https\";\nimport type { ServerFactory } from \"../types\";\n\n/**\n * Creates a server factory that uses the standard Node.js `http` module.\n * @returns A ServerFactory compatible with Shokupan.\n */\nexport function createHttpServer(): ServerFactory {\n    return async (options: any): Promise<Server> => {\n        const server = http.createServer(async (req, res) => {\n            const url = new URL(req.url!, `http://${req.headers.host}`);\n            const request = new Request(url.toString(), {\n                method: req.method,\n                headers: req.headers as any,\n                body: ['GET', 'HEAD'].includes(req.method!) ? undefined : new ReadableStream({\n                    start(controller) {\n                        req.on('data', chunk => controller.enqueue(chunk));\n                        req.on('end', () => controller.close());\n                        req.on('error', err => controller.error(err));\n                    }\n                }) as any,\n                // Required for Node.js undici when sending a body\n                duplex: 'half'\n            } as any);\n\n            const response = await options.fetch(request, fauxServer);\n\n            res.statusCode = response.status;\n            response.headers.forEach((v, k) => res.setHeader(k, v));\n\n            if (response.body) {\n                // Optimize: Use arrayBuffer for direct conversion instead of async iteration\n                const buffer = await response.arrayBuffer();\n                res.end(Buffer.from(buffer));\n            } else {\n                res.end();\n            }\n        });\n\n        const fauxServer: Server = {\n            stop: () => {\n                server.close();\n                return Promise.resolve(); // Bun.Server stop usually returns void but in type definition it might vary.\n            },\n            upgrade(req, options) {\n                return false;\n            },\n            reload(options) {\n                return fauxServer as any;\n            },\n            get port() {\n                const addr = server.address();\n                if (typeof addr === 'object' && addr !== null) {\n                    return addr.port;\n                }\n                return options.port;\n            },\n            hostname: options.hostname,\n            development: options.development,\n            pendingRequests: 0,\n            requestIP: (req) => null,\n            publish: () => 0,\n            subscriberCount: () => 0,\n            url: new URL(`http://${options.hostname}:${options.port}`)\n        } as unknown as Server;\n\n        return new Promise((resolve) => {\n            server.listen(options.port, options.hostname, () => {\n                resolve(fauxServer);\n            });\n        });\n    };\n}\n\n/**\n * Creates a server factory that uses the standard Node.js `https` module.\n * @param sslOptions - Node.js HTTPS options (key, cert, etc.)\n * @returns A ServerFactory compatible with Shokupan.\n */\nexport function createHttpsServer(sslOptions: https.ServerOptions): ServerFactory {\n    return async (options: any): Promise<Server> => {\n        const server = https.createServer(sslOptions, async (req, res) => {\n            const url = new URL(req.url!, `https://${req.headers.host}`);\n            const request = new Request(url.toString(), {\n                method: req.method,\n                headers: req.headers as any,\n                body: ['GET', 'HEAD'].includes(req.method!) ? undefined : new ReadableStream({\n                    start(controller) {\n                        req.on('data', chunk => controller.enqueue(chunk));\n                        req.on('end', () => controller.close());\n                        req.on('error', err => controller.error(err));\n                    }\n                }) as any,\n                // Required for Node.js undici when sending a body\n                duplex: 'half'\n            } as any);\n\n            const response = await options.fetch(request, fauxServer);\n\n            res.statusCode = response.status;\n            response.headers.forEach((v, k) => res.setHeader(k, v));\n\n            if (response.body) {\n                // Optimize: Use arrayBuffer for direct conversion instead of async iteration\n                const buffer = await response.arrayBuffer();\n                res.end(Buffer.from(buffer));\n            } else {\n                res.end();\n            }\n        });\n\n        const fauxServer: Server = {\n            stop: () => {\n                server.close();\n            },\n            upgrade(req, options) {\n                return false;\n            },\n            reload(options) {\n                return fauxServer as any;\n            },\n            get port() {\n                const addr = server.address();\n                if (typeof addr === 'object' && addr !== null) {\n                    return addr.port;\n                }\n                return options.port;\n            },\n            hostname: options.hostname,\n            development: options.development,\n            pendingRequests: 0,\n            requestIP: (req) => null,\n            publish: () => 0,\n            subscriberCount: () => 0,\n            url: new URL(`https://${options.hostname}:${options.port}`)\n        } as unknown as Server;\n\n        return new Promise((resolve) => {\n            server.listen(options.port, options.hostname, () => {\n                resolve(fauxServer);\n            });\n        });\n    };\n}\n"],"names":["http","options"],"mappings":";;;;;;;;;;;;;;;;;;;;;AASO,SAAS,mBAAkC;AAC9C,SAAO,OAAO,YAAkC;AAC5C,UAAM,SAASA,gBAAK,aAAa,OAAO,KAAK,QAAQ;AACjD,YAAM,MAAM,IAAI,IAAI,IAAI,KAAM,UAAU,IAAI,QAAQ,IAAI,EAAE;AAC1D,YAAM,UAAU,IAAI,QAAQ,IAAI,YAAY;AAAA,QACxC,QAAQ,IAAI;AAAA,QACZ,SAAS,IAAI;AAAA,QACb,MAAM,CAAC,OAAO,MAAM,EAAE,SAAS,IAAI,MAAO,IAAI,SAAY,IAAI,eAAe;AAAA,UACzE,MAAM,YAAY;AACd,gBAAI,GAAG,QAAQ,CAAA,UAAS,WAAW,QAAQ,KAAK,CAAC;AACjD,gBAAI,GAAG,OAAO,MAAM,WAAW,OAAO;AACtC,gBAAI,GAAG,SAAS,CAAA,QAAO,WAAW,MAAM,GAAG,CAAC;AAAA,UAChD;AAAA,QAAA,CACH;AAAA;AAAA,QAED,QAAQ;AAAA,MAAA,CACJ;AAER,YAAM,WAAW,MAAM,QAAQ,MAAM,SAAS,UAAU;AAExD,UAAI,aAAa,SAAS;AAC1B,eAAS,QAAQ,QAAQ,CAAC,GAAG,MAAM,IAAI,UAAU,GAAG,CAAC,CAAC;AAEtD,UAAI,SAAS,MAAM;AAEf,cAAM,SAAS,MAAM,SAAS,YAAA;AAC9B,YAAI,IAAI,OAAO,KAAK,MAAM,CAAC;AAAA,MAC/B,OAAO;AACH,YAAI,IAAA;AAAA,MACR;AAAA,IACJ,CAAC;AAED,UAAM,aAAqB;AAAA,MACvB,MAAM,MAAM;AACR,eAAO,MAAA;AACP,eAAO,QAAQ,QAAA;AAAA,MACnB;AAAA,MACA,QAAQ,KAAKC,UAAS;AAClB,eAAO;AAAA,MACX;AAAA,MACA,OAAOA,UAAS;AACZ,eAAO;AAAA,MACX;AAAA,MACA,IAAI,OAAO;AACP,cAAM,OAAO,OAAO,QAAA;AACpB,YAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAC3C,iBAAO,KAAK;AAAA,QAChB;AACA,eAAO,QAAQ;AAAA,MACnB;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,aAAa,QAAQ;AAAA,MACrB,iBAAiB;AAAA,MACjB,WAAW,CAAC,QAAQ;AAAA,MACpB,SAAS,MAAM;AAAA,MACf,iBAAiB,MAAM;AAAA,MACvB,KAAK,IAAI,IAAI,UAAU,QAAQ,QAAQ,IAAI,QAAQ,IAAI,EAAE;AAAA,IAAA;AAG7D,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC5B,aAAO,OAAO,QAAQ,MAAM,QAAQ,UAAU,MAAM;AAChD,gBAAQ,UAAU;AAAA,MACtB,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AACJ;;"}

package/dist/shokupan.d.ts

@@ -2,13 +2,12 @@ import { ShokupanRequest } from './request';
 import { ShokupanRouter } from './router';
 import { $dispatch } from './symbol';
 import { Middleware, ProcessResult, RequestOptions, ShokupanConfig } from './types';
+import { Server } from 'bun';
 export declare class Shokupan<T = any> extends ShokupanRouter<T> {
     readonly applicationConfig: ShokupanConfig;
     openApiSpec?: any;
     private composedMiddleware?;
     private cpuMonitor?;
-    private hookCache;
-    private hooksInitialized;
     get logger(): {
         verbose?: boolean;
         info?: (msg: string, props: Record<string, any>) => void;
@@ -39,12 +38,12 @@ export declare class Shokupan<T = any> extends ShokupanRouter<T> {
      * @param port - The port to listen on. If not specified, the port from the configuration is used. If that is not specified, port 3000 is used.
      * @returns The server instance.
      */
-    listen(port?: number): Promise<any>;
+    listen(port?: number): Promise<Server | import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse>>;
     [$dispatch](req: ShokupanRequest<T>): Promise<Response>;
     /**
      * Processes a request by wrapping the standard fetch method.
      */
-    processRequest(options: RequestOptions): Promise<ProcessResult>;
+    testRequest(options: RequestOptions): Promise<ProcessResult>;
     /**
      * Handles an incoming request (Bun.serve interface).
      * This logic contains the middleware chain and router dispatch.
@@ -53,9 +52,6 @@ export declare class Shokupan<T = any> extends ShokupanRouter<T> {
      * @param server - The server instance.
      * @returns The response to send.
      */
-    fetch(req: Request, server?: import('bun').Server<any>): Promise<Response>;
+    fetch(req: Request, server?: Server): Promise<Response>;
     private handleRequest;
-    private ensureHooksInitialized;
-    private executeHook;
-    private hasHook;
 }

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import { OpenAPI } from '@scalar/openapi-types';
 import { Server } from 'bun';
+import { Server as NodeServer } from 'node:http';
 import { ShokupanContext } from './context';
 import { $isRouter } from './symbol';
 export type DeepPartial<T> = T extends Function ? T : T extends object ? {
@@ -27,7 +28,7 @@ export interface OpenAPIOptions {
     defaultTag?: string;
 }
 export interface ShokupanHooks<T = any> {
-    onError?: (error: unknown, ctx: ShokupanContext<T>) => void | Promise<void>;
+    onError?: (ctx: ShokupanContext<T>, error: unknown) => void | Promise<void>;
     onRequestStart?: (ctx: ShokupanContext<T>) => void | Promise<void>;
     onRequestEnd?: (ctx: ShokupanContext<T>) => void | Promise<void>;
     onResponseStart?: (ctx: ShokupanContext<T>, response: Response) => void | Promise<void>;
@@ -60,7 +61,7 @@ export declare enum RouteParamType {
     CONTEXT = "CONTEXT"
 }
 export interface ServerFactory {
-    (options: any): Server<any> | Promise<Server<any>>;
+    (options: any): Server | Promise<Server> | NodeServer | Promise<NodeServer>;
 }
 export type NextFn = () => Promise<any>;
 export type Middleware = ((ctx: ShokupanContext<unknown>, next: NextFn) => Promise<any> | any) & {
@@ -88,10 +89,12 @@ export type ShokupanRouteConfig = DeepPartial<{
     hooks: ShokupanHooks | ShokupanHooks[];
     /**
      * Whether to enforce that only controller classes (constructors) are accepted by the router.
+     * @default false
      */
     controllersOnly: boolean;
     /**
      * Whether to enable automatic backpressure based on system CPU load.
+     * @default false
      */
     autoBackpressureFeedback: boolean;
     /**
@@ -213,13 +216,29 @@ export type ShokupanConfig<T extends Record<string, any> = Record<string, any>>
      * @default false
      */
     enableTracing?: boolean;
+    /**
+     * JSON parser to use for parsing request bodies.
+     *
+     * Options:
+     * - `'native'`: Use the built-in JSON.parse (fastest, default)
+     * - `'parse-json'`: Use the parse-json library for better error messages with minimal performance overhead (~5% slower than native)
+     * - `'secure-json-parse'`: Use secure-json-parse for protection against prototype pollution (20-30% slower than native)
+     *
+     * Performance implications based on benchmarks:
+     * - `native`: Fastest option, excellent for production
+     * - `parse-json`: Nearly identical performance to native with better error messages, good for development
+     * - `secure-json-parse`: Provides security at the cost of performance, use only for untrusted input
+     *
+     * @default 'native'
+     */
+    jsonParser?: 'native' | 'parse-json' | 'secure-json-parse';
     /**
      * Whether to enable automatic backpressure based on system CPU load.
      * @default false
      */
     autoBackpressureFeedback?: boolean;
     /**
-     * The CPU usage percentage threshold (0-100) at which to start rejecting requests.
+     * The CPU usage percentage threshold (0-100) at which to start rejecting requests (429).
      * @default 60
      */
     autoBackpressureLevel?: number;
@@ -276,6 +295,7 @@ export type ShokupanConfig<T extends Record<string, any> = Record<string, any>>
     /**
      * Timeout for writing the response (milliseconds).
      * Not currently supported by Bun.serve natively.
+     * @experimental
      */
     writeTimeout: number;
     /**
@@ -291,6 +311,15 @@ export type ShokupanConfig<T extends Record<string, any> = Record<string, any>>
      * Lifecycle hooks.
      */
     hooks: ShokupanHooks<T> | ShokupanHooks<T>[];
+    /**
+     * Whether to validate response status codes.
+     * @default true
+     */
+    validateStatusCodes: boolean;
+    /**
+     * Any other config options are allowed, but will be ignored.
+     * @deprecated
+     */
     [key: string]: any;
 }>;
 export interface RequestOptions {

package/dist/util/datastore.d.ts

@@ -0,0 +1,6 @@
+export declare const datastore: {
+    get<T extends Record<string, any>>(store: string, key: string): Promise<T>;
+    set(store: string, key: string, value: any): Promise<any>;
+    query(query: string, vars?: Record<string, unknown>): Promise<any>;
+    readonly ready: Promise<any>;
+};

package/dist/util/json-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON parser utilities for Shokupan
+ * Supports multiple JSON parsing libraries with different performance characteristics
+ */
+type JSONParser = (text: string) => any;
+/**
+ * Get the appropriate JSON parser based on the configuration
+ * @param parserType - The type of parser to use
+ * @returns A JSON parsing function
+ */
+export declare function getJSONParser(parserType?: 'native' | 'parse-json' | 'secure-json-parse'): JSONParser;
+export {};

package/dist/util/plugin-deps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Plugin dependency loader with helpful error messages
+ * Provides lazy loading for optional plugin dependencies
+ */
+/**
+ * Loads a plugin dependency with helpful error message if not installed
+ * @param packageName The npm package to load
+ * @param pluginName The shokupan plugin that requires it
+ * @param installCommand Optional custom install command
+ */
+export declare function loadPluginDependency(packageName: string, pluginName: string, installCommand?: string): Promise<any>;
+/**
+ * Loads multiple plugin dependencies
+ * @param dependencies Array of dependency info
+ */
+export declare function loadPluginDependencies(dependencies: Array<{
+    package: string;
+    plugin: string;
+    installCommand?: string;
+}>): Promise<Record<string, any>>;
+/**
+ * Checks if a package is available without throwing
+ * @param packageName The npm package to check
+ */
+export declare function isPackageAvailable(packageName: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "shokupan",
-    "version": "0.4.5",
+    "version": "0.6.0",
     "description": "Shokupan is a low-lift modern web framework for Bun.",
     "author": "Andrew G. Knackstedt",
     "publishConfig": {
@@ -27,7 +27,8 @@
         "docs": "cd docs && bun run dev",
         "build": "vite build",
         "bench": "cd src/benchmarking && bun runner.ts",
-        "bench:advanced": "cd src/benchmarking && bun advanced-runner.ts"
+        "bench:advanced": "cd src/benchmarking && bun advanced-runner.ts",
+        "retag": "git push origin :refs/tags/v$(node -p \"require('./package.json').version\") 2>/dev/null || true && git tag -d v$(node -p \"require('./package.json').version\") 2>/dev/null || true && git tag v$(node -p \"require('./package.json').version\") && git push origin v$(node -p \"require('./package.json').version\") --force"
     },
     "bin": {
         "shokupan": "dist/cli.js",
@@ -63,33 +64,92 @@
         "@opentelemetry/sdk-trace-base": "^2.2.0",
         "@opentelemetry/sdk-trace-node": "^2.2.0",
         "@opentelemetry/semantic-conventions": "^1.38.0",
-        "@scalar/api-reference": "^1.40.9",
         "@scalar/openapi-types": "^0.5.3",
-        "@surrealdb/node": "^2.4.0",
-        "ajv": "^8.17.1",
-        "ajv-formats": "^3.0.1",
-        "arctic": "^3.7.0",
-        "class-transformer": "^0.5.1",
-        "class-validator": "^0.14.3",
-        "eta": "^4.5.0",
-        "jose": "^6.1.3",
-        "reflect-metadata": "^0.2.2",
-        "surrealdb": "^2.0.0-alpha.14",
         "tslib": "^2.8.1"
     },
+    "peerDependencies": {
+        "ajv": "^8.0.0",
+        "ajv-formats": "^3.0.0",
+        "arctic": "^3",
+        "class-transformer": "^0.5.0",
+        "class-validator": "^0.14.0",
+        "eta": "^4.0.0",
+        "jose": "^6.0.0",
+        "parse-json": "^8.0.0",
+        "reflect-metadata": "^0.2.0",
+        "secure-json-parse": "^4.0.0",
+        "@scalar/api-reference": "^1.0.0",
+        "@surrealdb/node": "^2.4.0",
+        "surrealdb": "^2.0.0-alpha.14"
+    },
+    "peerDependenciesMeta": {
+        "ajv": {
+            "optional": true
+        },
+        "ajv-formats": {
+            "optional": true
+        },
+        "arctic": {
+            "optional": true
+        },
+        "class-transformer": {
+            "optional": true
+        },
+        "class-validator": {
+            "optional": true
+        },
+        "eta": {
+            "optional": true
+        },
+        "jose": {
+            "optional": true
+        },
+        "parse-json": {
+            "optional": true
+        },
+        "reflect-metadata": {
+            "optional": true
+        },
+        "secure-json-parse": {
+            "optional": true
+        },
+        "@scalar/api-reference": {
+            "optional": true
+        },
+        "@surrealdb/node": {
+            "optional": true
+        },
+        "surrealdb": {
+            "optional": true
+        }
+    },
     "devDependencies": {
+        "@scalar/api-reference": "^1.0.0",
         "@sinclair/typebox": "^0.34.45",
+        "@surrealdb/node": "^2.4.0",
         "@tsconfig/bun": "^1.0.8",
         "@types/axios": "^0.9.36",
         "@types/bun": "^1.2.23",
         "@types/supertest": "^6.0.3",
+        "ajv": "^8.0.0",
+        "ajv-formats": "^3.0.0",
+        "arctic": "^3",
         "axios": "^1.13.2",
+        "class-transformer": "^0.5.0",
+        "class-validator": "^0.14.0",
+        "eta": "^4.0.0",
+        "fast-json-stringify": "^6.1.1",
         "get-port": "^7.1.0",
+        "jose": "^6.0.0",
+        "parse-json": "^8.0.0",
+        "reflect-metadata": "^0.2.0",
+        "secure-json-parse": "^4.0.0",
         "supertest": "^7.1.4",
+        "surrealdb": "^2.0.0-alpha.14",
         "typescript": "~5.9.3",
         "valibot": "^1.2.0",
         "vite": "^7.3.0",
         "vite-plugin-dts": "^4.5.4",
         "zod": "^4.2.1"
     }
-}
+}

package/dist/benchmarking/advanced-cases/elysia.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/express.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/fastify.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/hapi.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/hono.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/koa.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/nest.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-cases/shokupan.d.ts

@@ -1 +0,0 @@
-export declare function startAdvanced(port: number, scenario: string): Promise<() => Promise<void>>;

package/dist/benchmarking/advanced-data.d.ts

@@ -1,33 +0,0 @@
-export declare const LARGE_JSON: {
-    total: number;
-    items: any[];
-    metadata: {
-        generated: string;
-        size: string;
-        purpose: string;
-    };
-};
-export declare const LARGE_REQUEST_BODY: string;
-export declare const LARGE_HEADERS: Record<string, string>;
-/**
- * Calculate MD5 hash of a string
- */
-export declare function md5(input: string): string;
-/**
- * Serialize request data for hashing
- */
-export declare function serializeRequest(url: string, headers: Record<string, string>, body: string): string;
-/**
- * Get the actual byte size of the LARGE_JSON
- */
-export declare function getLargeJSONSize(): number;
-/**
- * Smaller compressible response (100KB) for compression testing
- */
-export declare const COMPRESSIBLE_JSON: {
-    data: {
-        id: number;
-        text: string;
-        timestamp: string;
-    }[];
-};

package/dist/benchmarking/advanced-runner.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/benchmarking/cases/elysia.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/express.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/fastify.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/hapi.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/hono.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/koa.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/nest.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/cases/shokupan.d.ts

@@ -1 +0,0 @@
-export declare function start(port: number): Promise<() => Promise<void>>;

package/dist/benchmarking/data.d.ts

@@ -1,15 +0,0 @@
-export declare const MEDIUM_JSON: {
-    id: number;
-    name: string;
-    timestamp: string;
-    tags: string[];
-    nested: {
-        layer1: {
-            layer2: {
-                value: string;
-                numbers: number[];
-            };
-        };
-    };
-    description: string;
-};

package/dist/benchmarking/quick_bench.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/benchmarking/runner.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/buntest.d.ts

@@ -1 +0,0 @@
-export {};