shokupan 0.6.0 → 0.7.0

package/dist/context.d.ts

@@ -1,9 +1,8 @@
 import { BodyInit, Server } from 'bun';
-import { ShokupanRequest } from './request';
-import { ShokupanResponse } from './response';
 import { Shokupan } from './shokupan';
-import { CookieOptions, JSXRenderer } from './types';
-type HeadersInit = Headers | Record<string, string> | [string, string][];
+import { ShokupanRequest } from './util/request';
+import { ShokupanResponse } from './util/response';
+import { CookieOptions, HeadersInit, JSXRenderer } from './util/types';
 export interface HandlerStackItem {
     name: string;
     file: string;
@@ -18,12 +17,73 @@ export interface DebugCollector {
     setNode(id: string): void;
     getCurrentNode(): string | undefined;
 }
-export declare class ShokupanContext<State extends Record<string, any> = Record<string, any>> {
+/**
+ * Shokupan Request Context
+ *
+ * The context object passed to all middleware and route handlers.
+ * Provides access to request data, response helpers, and typed state management.
+ *
+ * @template State - The shape of `ctx.state` for type-safe state access across middleware.
+ * @template Params - The shape of `ctx.params` based on the route path pattern.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * app.get('/hello', (ctx) => {
+ *   return ctx.json({ message: 'Hello' });
+ * });
+ * ```
+ *
+ * @example Typed State
+ * ```typescript
+ * interface AppState {
+ *   userId: string;
+ *   requestId: string;
+ * }
+ *
+ * const app = new Shokupan<AppState>();
+ *
+ * app.use((ctx, next) => {
+ *   ctx.state.requestId = crypto.randomUUID(); // ✓ Type-safe
+ *   return next();
+ * });
+ * ```
+ *
+ * @example Typed Path Parameters
+ * ```typescript
+ * app.get('/users/:userId/posts/:postId', (ctx) => {
+ *   // ctx.params is automatically typed as { userId: string; postId: string }
+ *   const { userId, postId } = ctx.params;
+ *   return ctx.json({ userId, postId });
+ * });
+ * ```
+ *
+ * @example Full Type Safety (State + Params)
+ * ```typescript
+ * interface RequestState {
+ *   userId: string;
+ *   permissions: string[];
+ * }
+ *
+ * const app = new Shokupan<RequestState>();
+ *
+ * app.get('/admin/users/:userId', (ctx) => {
+ *   // Both typed!
+ *   const { userId } = ctx.params;        // ✓ From path
+ *   const { permissions } = ctx.state;     // ✓ From state
+ *
+ *   if (!permissions.includes('admin')) {
+ *     return ctx.json({ error: 'Forbidden' }, 403);
+ *   }
+ *   return ctx.json({ userId });
+ * });
+ * ```
+ */
+export declare class ShokupanContext<State extends Record<string, any> = Record<string, any>, Params extends Record<string, string> = Record<string, string>> {
     readonly request: ShokupanRequest<any>;
     readonly server?: Server;
     readonly app?: Shokupan;
     readonly signal?: AbortSignal;
-    params: Record<string, string>;
+    params: Params;
     state: State;
     handlerStack: HandlerStackItem[];
     readonly response: ShokupanResponse;
@@ -35,11 +95,17 @@ export declare class ShokupanContext<State extends Record<string, any> = Record<
     private _bodyType?;
     private _bodyParsed;
     _bodyParseError?: Error;
+    _routeMatched: boolean;
     private _cachedHostname?;
     private _cachedProtocol?;
     private _cachedHost?;
     private _cachedOrigin?;
     private _cachedQuery?;
+    /**
+     * JSX Rendering Function
+     */
+    private renderer?;
+    setRenderer(renderer: JSXRenderer): void;
     constructor(request: ShokupanRequest<any>, server?: Server, state?: State, app?: Shokupan, signal?: AbortSignal, // Optional as it might not be provided in tests or simple creates
     enableMiddlewareTracking?: boolean);
     get url(): URL;
@@ -159,10 +225,6 @@ export declare class ShokupanContext<State extends Record<string, any> = Record<
      * Respond with a file
      */
     file(path: string, fileOptions?: BlobPropertyBag, responseOptions?: ResponseInit): Promise<Response>;
-    /**
-     * JSX Rendering Function
-     */
-    renderer?: JSXRenderer;
     /**
      * Render a JSX element
      * @param element JSX Element
@@ -171,4 +233,3 @@ export declare class ShokupanContext<State extends Record<string, any> = Record<
      */
     jsx(element: any, args?: Parameters<JSXRenderer>[1], status?: number, headers?: HeadersInit): Promise<Response>;
 }
-export {};

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

@@ -63,4 +63,4 @@ function createHttpServer() {
 export {
   createHttpServer
 };
-//# sourceMappingURL=server-adapter-0xH174zz.js.map
+//# sourceMappingURL=http-server-0xH174zz.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-server-0xH174zz.js","sources":["../src/plugins/application/http-server.ts"],"sourcesContent":["import type { Server } from \"bun\";\nimport * as http from \"node:http\";\nimport * as https from \"node:https\";\nimport type { ServerFactory } from \"../../util/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-DFhwlK8e.cjs → http-server-DFhwlK8e.cjs}

@@ -80,4 +80,4 @@ function createHttpServer() {
   };
 }
 exports.createHttpServer = createHttpServer;
-//# sourceMappingURL=server-adapter-DFhwlK8e.cjs.map
+//# sourceMappingURL=http-server-DFhwlK8e.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-server-DFhwlK8e.cjs","sources":["../src/plugins/application/http-server.ts"],"sourcesContent":["import type { Server } from \"bun\";\nimport * as http from \"node:http\";\nimport * as https from \"node:https\";\nimport type { ServerFactory } from \"../../util/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;;"}