@bunary/http 0.0.2 → 0.0.4

package/dist/pathUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Path manipulation utilities for route handling.
+ */
+/**
+ * Normalize a path prefix (ensure leading slash, no trailing slash).
+ *
+ * @param prefix - Path prefix to normalize
+ * @returns Normalized prefix with leading slash and no trailing slash
+ *
+ * @example
+ * ```ts
+ * normalizePrefix("api")     // "/api"
+ * normalizePrefix("/api/")   // "/api"
+ * normalizePrefix("/")       // "/"
+ * ```
+ */
+export declare function normalizePrefix(prefix: string): string;
+/**
+ * Join path segments, handling slashes correctly.
+ *
+ * @param prefix - Path prefix
+ * @param path - Path to append
+ * @returns Combined path
+ *
+ * @example
+ * ```ts
+ * joinPaths("/api", "/users")  // "/api/users"
+ * joinPaths("/api", "users")   // "/api/users"
+ * joinPaths("/api/", "/users") // "/api/users"
+ * joinPaths("/", "/")          // "/"
+ * ```
+ */
+export declare function joinPaths(prefix: string, path: string): string;
+//# sourceMappingURL=pathUtils.d.ts.map

package/dist/pathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../src/pathUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAc9D"}

package/dist/response.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Response conversion utilities for route handlers.
+ */
+import type { HandlerResponse } from "./types/index.js";
+/**
+ * Convert a handler response to a proper Response object.
+ *
+ * Handles the following response types:
+ * - Response: passed through unchanged
+ * - null/undefined: 204 No Content
+ * - string: text/plain response
+ * - number: text/plain response
+ * - object/array: JSON response
+ *
+ * @param result - The handler return value
+ * @returns A proper Response object
+ *
+ * @example
+ * ```ts
+ * toResponse({ message: "Hello" });  // JSON response
+ * toResponse("Hello");               // text/plain response
+ * toResponse(null);                  // 204 No Content
+ * ```
+ */
+export declare function toResponse(result: HandlerResponse): Response;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAgC5D"}

package/dist/router.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Route matching utilities for compiling paths and extracting parameters.
+ */
+import type { Route } from "./types/index.js";
+/**
+ * Result of compiling a path pattern.
+ */
+export interface CompiledPath {
+    /** Regex pattern for matching */
+    pattern: RegExp;
+    /** Parameter names in order */
+    paramNames: string[];
+    /** Names of optional parameters */
+    optionalParams: string[];
+}
+/**
+ * Compile a path pattern into a regex and extract parameter names.
+ * Supports optional parameters with :param? syntax.
+ *
+ * @param path - Route path pattern (e.g., "/users/:id" or "/users/:id?")
+ * @returns Object with regex pattern, parameter names, and optional param names
+ *
+ * @example
+ * ```ts
+ * const { pattern, paramNames, optionalParams } = compilePath("/users/:id?");
+ * // pattern matches "/users" and "/users/123"
+ * // paramNames = ["id"]
+ * // optionalParams = ["id"]
+ * ```
+ */
+export declare function compilePath(path: string): CompiledPath;
+/**
+ * Extract path parameters from a matched route.
+ * Handles optional parameters by only including them if they have values.
+ *
+ * @param path - The request path
+ * @param route - The matched route
+ * @returns Record of parameter names to values (undefined for missing optional params)
+ */
+export declare function extractParams(path: string, route: Route): Record<string, string | undefined>;
+/**
+ * Check if route constraints are satisfied.
+ *
+ * @param params - Extracted route parameters
+ * @param constraints - Parameter constraints (regex patterns)
+ * @returns True if all constraints pass
+ */
+export declare function checkConstraints(params: Record<string, string | undefined>, constraints?: Record<string, RegExp>): boolean;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mCAAmC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAmCtD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAa5F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAUT"}

package/dist/routes/builder.d.ts

@@ -0,0 +1,17 @@
+import type { BunaryApp, Route, RouteBuilder } from "../types/index.js";
+/**
+ * Safely compile a string pattern to RegExp with error handling.
+ * Provides better error messages for invalid regex patterns.
+ */
+export declare function compilePattern(pattern: string, param: string): RegExp;
+/**
+ * Create a RouteBuilder for a specific route.
+ * Each builder captures its own route reference to avoid shared mutable state issues.
+ */
+export declare function createRouteBuilder(route: Route, namedRoutes: Map<string, Route>, app: BunaryApp): RouteBuilder;
+/**
+ * Wrap a route builder to auto-apply name prefix.
+ * Uses a Proxy to maintain dynamic getter behavior from the original builder.
+ */
+export declare function wrapBuilderWithNamePrefix(builder: RouteBuilder, namePrefix: string): RouteBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/routes/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/routes/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAC/B,GAAG,EAAE,SAAS,GACZ,YAAY,CAmHd;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAajG"}

package/dist/routes/find.d.ts

@@ -0,0 +1,27 @@
+import type { Route } from "../types/index.js";
+export interface RouteMatch {
+    route: Route;
+    params: Record<string, string | undefined>;
+}
+/**
+ * Find a matching route for the given method and path.
+ *
+ * **Complexity**: O(n) where n is the number of registered routes.
+ * Routes are tested sequentially until a match is found.
+ *
+ * This linear search is suitable for most applications (up to ~100 routes).
+ * For applications with hundreds of routes, consider:
+ * - Grouping routes by common prefixes (reduces regex tests per request)
+ * - Using method-based route maps (the 405 "Method Not Allowed" check already
+ *   iterates separately, so grouping by method could help)
+ * - Implementing a radix/prefix tree for static path segments
+ *
+ * The current design prioritizes simplicity and correctness. Route order matters:
+ * the first matching route wins, allowing intentional route shadowing.
+ */
+export declare function findRoute(routes: Route[], method: string, path: string): RouteMatch | null;
+/**
+ * Check if any route matches the path (regardless of method).
+ */
+export declare function hasMatchingPath(routes: Route[], path: string): boolean;
+//# sourceMappingURL=find.d.ts.map

package/dist/routes/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/routes/find.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAc1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMtE"}

package/dist/routes/group.d.ts

@@ -0,0 +1,7 @@
+import type { GroupRouter, Middleware, RouteBuilder, RouteHandler } from "../types/index.js";
+export type AddRouteFn = (method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH", path: string, handler: RouteHandler, groupMiddleware?: Middleware[]) => RouteBuilder;
+/**
+ * Create a group router for defining routes within a group.
+ */
+export declare function createGroupRouter(prefix: string, groupMiddleware: Middleware[], namePrefix: string, addRoute: AddRouteFn): GroupRouter;
+//# sourceMappingURL=group.d.ts.map

package/dist/routes/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/routes/group.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,UAAU,GAAG,CACxB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,EACnD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,eAAe,CAAC,EAAE,UAAU,EAAE,KAC1B,YAAY,CAAC;AAElB;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,UAAU,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,GAClB,WAAW,CAoDb"}

package/dist/routes/index.d.ts

@@ -0,0 +1,4 @@
+export { createRouteBuilder, compilePattern, wrapBuilderWithNamePrefix } from "./builder.js";
+export { findRoute, hasMatchingPath, type RouteMatch } from "./find.js";
+export { createGroupRouter, type AddRouteFn } from "./group.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/appOptions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration options for creating a Bunary app.
+ */
+export interface AppOptions {
+    /** Base path prefix for all routes (default: "") */
+    basePath?: string;
+}
+//# sourceMappingURL=appOptions.d.ts.map

package/dist/types/appOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appOptions.d.ts","sourceRoot":"","sources":["../../src/types/appOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/bunaryApp.d.ts

@@ -0,0 +1,97 @@
+import type { BunaryServer } from "./bunaryServer.js";
+import type { GroupOptions } from "./groupOptions.js";
+import type { GroupCallback } from "./groupRouter.js";
+import type { Middleware } from "./middleware.js";
+import type { RouteBuilder } from "./routeBuilder.js";
+import type { RouteHandler } from "./routeHandler.js";
+import type { RouteInfo } from "./routeInfo.js";
+/**
+ * The Bunary application instance for HTTP routing and middleware.
+ *
+ * @example
+ * ```ts
+ * const app = createApp();
+ *
+ * app.get("/", () => ({ message: "Hello!" }));
+ * app.get("/users/:id", (ctx) => ({ id: ctx.params.id }));
+ *
+ * app.listen(3000);
+ * ```
+ */
+export interface BunaryApp {
+    /**
+     * Register a GET route.
+     * @param path - URL path pattern (supports :param and :param? syntax)
+     * @param handler - Function to handle requests
+     */
+    get: (path: string, handler: RouteHandler) => RouteBuilder;
+    /**
+     * Register a POST route.
+     * @param path - URL path pattern (supports :param and :param? syntax)
+     * @param handler - Function to handle requests
+     */
+    post: (path: string, handler: RouteHandler) => RouteBuilder;
+    /**
+     * Register a PUT route.
+     * @param path - URL path pattern (supports :param and :param? syntax)
+     * @param handler - Function to handle requests
+     */
+    put: (path: string, handler: RouteHandler) => RouteBuilder;
+    /**
+     * Register a DELETE route.
+     * @param path - URL path pattern (supports :param and :param? syntax)
+     * @param handler - Function to handle requests
+     */
+    delete: (path: string, handler: RouteHandler) => RouteBuilder;
+    /**
+     * Register a PATCH route.
+     * @param path - URL path pattern (supports :param and :param? syntax)
+     * @param handler - Function to handle requests
+     */
+    patch: (path: string, handler: RouteHandler) => RouteBuilder;
+    /**
+     * Add middleware to the request pipeline.
+     * Middleware executes in registration order.
+     * @param middleware - Middleware function
+     */
+    use: (middleware: Middleware) => BunaryApp;
+    /**
+     * Create a route group with shared prefix, middleware, or name prefix.
+     * @param prefix - URL prefix for all routes in the group
+     * @param callback - Function to define routes within the group
+     */
+    group: ((prefix: string, callback: GroupCallback) => BunaryApp) & ((options: GroupOptions, callback: GroupCallback) => BunaryApp);
+    /**
+     * Generate a URL for a named route.
+     * @param name - The route name
+     * @param params - Route parameters and query string values
+     * @returns The generated URL path
+     * @throws If route name not found or required params missing
+     */
+    route: (name: string, params?: Record<string, string | number>) => string;
+    /**
+     * Check if a named route exists.
+     * @param name - The route name to check
+     * @returns True if the route exists
+     */
+    hasRoute: (name: string) => boolean;
+    /**
+     * Get a list of all registered routes.
+     * @returns Array of route information objects
+     */
+    getRoutes: () => RouteInfo[];
+    /**
+     * Start the HTTP server.
+     * @param port - Port number to listen on (default: 3000)
+     * @param hostname - Hostname to bind to (default: "localhost")
+     * @returns Server instance with stop() method
+     */
+    listen: (port?: number, hostname?: string) => BunaryServer;
+    /**
+     * Handle an incoming request (used internally and for testing).
+     * @param request - The incoming Request object
+     * @returns Response object
+     */
+    fetch: (request: Request) => Promise<Response>;
+}
+//# sourceMappingURL=bunaryApp.d.ts.map

package/dist/types/bunaryApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunaryApp.d.ts","sourceRoot":"","sources":["../../src/types/bunaryApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACzB;;;;OAIG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAE3D;;;;OAIG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAE5D;;;;OAIG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAE3D;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAE9D;;;;OAIG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAE7D;;;;OAIG;IACH,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC;IAE3C;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,SAAS,CAAC,GAC9D,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;IAE1E;;;;OAIG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEpC;;;OAGG;IACH,SAAS,EAAE,MAAM,SAAS,EAAE,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;IAE3D;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/C"}

package/dist/types/bunaryServer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Server instance returned by app.listen().
+ */
+export interface BunaryServer {
+    /** The underlying Bun server */
+    server: ReturnType<typeof Bun.serve>;
+    /** Stop the server */
+    stop: () => void;
+    /** Port the server is listening on */
+    port: number;
+    /** Hostname the server is bound to */
+    hostname: string;
+}
+//# sourceMappingURL=bunaryServer.d.ts.map

package/dist/types/bunaryServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunaryServer.d.ts","sourceRoot":"","sources":["../../src/types/bunaryServer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,MAAM,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,sBAAsB;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/groupOptions.d.ts

@@ -0,0 +1,13 @@
+import type { Middleware } from "./middleware.js";
+/**
+ * Options for route groups.
+ */
+export interface GroupOptions {
+    /** URL prefix for all routes in the group */
+    prefix: string;
+    /** Middleware to apply to all routes in the group */
+    middleware?: Middleware[];
+    /** Name prefix for all routes in the group */
+    name?: string;
+}
+//# sourceMappingURL=groupOptions.d.ts.map

package/dist/types/groupOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupOptions.d.ts","sourceRoot":"","sources":["../../src/types/groupOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/types/groupRouter.d.ts

@@ -0,0 +1,26 @@
+import type { GroupOptions } from "./groupOptions.js";
+import type { RouteBuilder } from "./routeBuilder.js";
+import type { RouteHandler } from "./routeHandler.js";
+/**
+ * Router interface for route groups.
+ * Provides the same routing methods as BunaryApp but scoped to a group.
+ */
+export interface GroupRouter {
+    /** Register a GET route */
+    get: (path: string, handler: RouteHandler) => RouteBuilder;
+    /** Register a POST route */
+    post: (path: string, handler: RouteHandler) => RouteBuilder;
+    /** Register a PUT route */
+    put: (path: string, handler: RouteHandler) => RouteBuilder;
+    /** Register a DELETE route */
+    delete: (path: string, handler: RouteHandler) => RouteBuilder;
+    /** Register a PATCH route */
+    patch: (path: string, handler: RouteHandler) => RouteBuilder;
+    /** Create a nested route group */
+    group: ((prefix: string, callback: GroupCallback) => GroupRouter) & ((options: GroupOptions, callback: GroupCallback) => GroupRouter);
+}
+/**
+ * Callback function for defining routes within a group.
+ */
+export type GroupCallback = (router: GroupRouter) => void;
+//# sourceMappingURL=groupRouter.d.ts.map

package/dist/types/groupRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupRouter.d.ts","sourceRoot":"","sources":["../../src/types/groupRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,2BAA2B;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAC3D,4BAA4B;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAC5D,2BAA2B;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAC3D,8BAA8B;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,6BAA6B;IAC7B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;IAC7D,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,WAAW,CAAC,GAChE,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,WAAW,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/types/handlerResponse.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return type for route handlers.
+ * - Objects/arrays are automatically serialized to JSON.
+ * - Response objects are passed through unchanged.
+ * - Primitives (string, number) are converted to text responses.
+ */
+export type HandlerResponse = Response | object | string | number | null | undefined;
+//# sourceMappingURL=handlerResponse.d.ts.map

package/dist/types/handlerResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlerResponse.d.ts","sourceRoot":"","sources":["../../src/types/handlerResponse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/dist/types/httpMethod.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTTP method types supported by the router.
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+//# sourceMappingURL=httpMethod.d.ts.map

package/dist/types/httpMethod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpMethod.d.ts","sourceRoot":"","sources":["../../src/types/httpMethod.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @bunary/http - Type Definitions
+ */
+export type { AppOptions } from "./appOptions.js";
+export type { BunaryApp } from "./bunaryApp.js";
+export type { BunaryServer } from "./bunaryServer.js";
+export type { GroupCallback, GroupRouter } from "./groupRouter.js";
+export type { GroupOptions } from "./groupOptions.js";
+export type { HandlerResponse } from "./handlerResponse.js";
+export type { HttpMethod } from "./httpMethod.js";
+export type { Middleware } from "./middleware.js";
+export type { PathParams } from "./pathParams.js";
+export type { QueryParams } from "./queryParams.js";
+export type { RequestContext } from "./requestContext.js";
+export type { Route } from "./route.js";
+export type { RouteBuilder } from "./routeBuilder.js";
+export type { RouteHandler } from "./routeHandler.js";
+export type { RouteInfo } from "./routeInfo.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/middleware.d.ts

@@ -0,0 +1,21 @@
+import type { HandlerResponse } from "./handlerResponse.js";
+import type { RequestContext } from "./requestContext.js";
+/**
+ * Middleware function for processing requests in a pipeline.
+ *
+ * @param ctx - The request context
+ * @param next - Function to call the next middleware or route handler
+ * @returns Response data or void (if next() handles it)
+ *
+ * @example
+ * ```ts
+ * const logger: Middleware = async (ctx, next) => {
+ *   console.log(`${ctx.request.method} ${ctx.request.url}`);
+ *   const response = await next();
+ *   console.log("Response sent");
+ *   return response;
+ * };
+ * ```
+ */
+export type Middleware = (ctx: RequestContext, next: () => Promise<HandlerResponse>) => HandlerResponse | Promise<HandlerResponse>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/types/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KAChC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/types/pathParams.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Path parameters extracted from route patterns (e.g., `/users/:id` → `{ id: "123" }`).
+ * Optional parameters may be undefined when not provided.
+ */
+export type PathParams = Record<string, string | undefined>;
+//# sourceMappingURL=pathParams.d.ts.map

package/dist/types/pathParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathParams.d.ts","sourceRoot":"","sources":["../../src/types/pathParams.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC"}

package/dist/types/queryParams.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Query parameters parsed from the URL search string.
+ */
+export type QueryParams = Record<string, string | string[]>;
+//# sourceMappingURL=queryParams.d.ts.map

package/dist/types/queryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/types/queryParams.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC"}

package/dist/types/requestContext.d.ts

@@ -0,0 +1,22 @@
+import type { PathParams } from "./pathParams.js";
+/**
+ * Context object passed to route handlers containing request data.
+ *
+ * @example
+ * ```ts
+ * app.get("/users/:id", (ctx) => {
+ *   console.log(ctx.params.id);      // "123"
+ *   console.log(ctx.query.get("sort")); // "name"
+ *   return { id: ctx.params.id };
+ * });
+ * ```
+ */
+export interface RequestContext {
+    /** The original Bun Request object */
+    request: Request;
+    /** Path parameters extracted from the route pattern */
+    params: PathParams;
+    /** Query parameters from the URL search string */
+    query: URLSearchParams;
+}
+//# sourceMappingURL=requestContext.d.ts.map

package/dist/types/requestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContext.d.ts","sourceRoot":"","sources":["../../src/types/requestContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC9B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,MAAM,EAAE,UAAU,CAAC;IACnB,kDAAkD;IAClD,KAAK,EAAE,eAAe,CAAC;CACvB"}

package/dist/types/route.d.ts

@@ -0,0 +1,27 @@
+import type { HttpMethod } from "./httpMethod.js";
+import type { Middleware } from "./middleware.js";
+import type { RouteHandler } from "./routeHandler.js";
+/**
+ * Internal route definition stored by the router.
+ */
+export interface Route {
+    /** HTTP method for this route */
+    method: HttpMethod;
+    /** Route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Compiled regex for matching */
+    pattern: RegExp;
+    /** Parameter names extracted from path */
+    paramNames: string[];
+    /** Handler function for this route */
+    handler: RouteHandler;
+    /** Optional route name for URL generation */
+    name?: string;
+    /** Parameter constraints (regex patterns) */
+    constraints?: Record<string, RegExp>;
+    /** Route-specific middleware */
+    middleware?: Middleware[];
+    /** Names of optional parameters */
+    optionalParams?: string[];
+}
+//# sourceMappingURL=route.d.ts.map

package/dist/types/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/types/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,iCAAiC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gCAAgC;IAChC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/types/routeBuilder.d.ts

@@ -0,0 +1,24 @@
+import type { BunaryApp } from "./bunaryApp.js";
+/**
+ * Fluent builder for route configuration.
+ * Allows chaining methods like name(), where(), etc.
+ */
+export interface RouteBuilder extends BunaryApp {
+    /** Assign a name to the route for URL generation */
+    name: (name: string) => RouteBuilder;
+    /** Add a regex constraint to a route parameter */
+    where: ((param: string, pattern: RegExp | string) => RouteBuilder) & ((constraints: Record<string, RegExp | string>) => RouteBuilder);
+    /** Constrain parameter to digits only */
+    whereNumber: (param: string) => RouteBuilder;
+    /** Constrain parameter to letters only */
+    whereAlpha: (param: string) => RouteBuilder;
+    /** Constrain parameter to letters and digits only */
+    whereAlphaNumeric: (param: string) => RouteBuilder;
+    /** Constrain parameter to UUID format */
+    whereUuid: (param: string) => RouteBuilder;
+    /** Constrain parameter to ULID format */
+    whereUlid: (param: string) => RouteBuilder;
+    /** Constrain parameter to specific allowed values */
+    whereIn: (param: string, values: string[]) => RouteBuilder;
+}
+//# sourceMappingURL=routeBuilder.d.ts.map

package/dist/types/routeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeBuilder.d.ts","sourceRoot":"","sources":["../../src/types/routeBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC9C,oDAAoD;IACpD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;IACrC,kDAAkD;IAClD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,KAAK,YAAY,CAAC,GACjE,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,YAAY,CAAC,CAAC;IAClE,yCAAyC;IACzC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;IAC7C,0CAA0C;IAC1C,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;IAC5C,qDAAqD;IACrD,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;IACnD,yCAAyC;IACzC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;IAC3C,yCAAyC;IACzC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;IAC3C,qDAAqD;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC;CAC3D"}

package/dist/types/routeHandler.d.ts

@@ -0,0 +1,17 @@
+import type { HandlerResponse } from "./handlerResponse.js";
+import type { RequestContext } from "./requestContext.js";
+/**
+ * Route handler function that processes incoming requests.
+ *
+ * @param ctx - The request context containing request, params, and query
+ * @returns Response data (object for JSON, Response for custom, or primitive)
+ *
+ * @example
+ * ```ts
+ * const handler: RouteHandler = (ctx) => {
+ *   return { message: "Hello, World!" };
+ * };
+ * ```
+ */
+export type RouteHandler = (ctx: RequestContext) => HandlerResponse | Promise<HandlerResponse>;
+//# sourceMappingURL=routeHandler.d.ts.map

package/dist/types/routeHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeHandler.d.ts","sourceRoot":"","sources":["../../src/types/routeHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/types/routeInfo.d.ts

@@ -0,0 +1,13 @@
+import type { HttpMethod } from "./httpMethod.js";
+/**
+ * Route information returned by getRoutes().
+ */
+export interface RouteInfo {
+    /** Route name (null if unnamed) */
+    name: string | null;
+    /** HTTP method */
+    method: HttpMethod;
+    /** Route path pattern */
+    path: string;
+}
+//# sourceMappingURL=routeInfo.d.ts.map

package/dist/types/routeInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeInfo.d.ts","sourceRoot":"","sources":["../../src/types/routeInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunary/http",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "HTTP routing and middleware for Bunary - a Bun-first backend framework inspired by Laravel",
   "type": "module",
   "main": "./dist/index.js",