@bunary/http 0.0.2 → 0.0.5

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,36 @@
+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;
+    /**
+     * Per-request storage for middleware and handlers.
+     *
+     * This object is **initialized per request** (never shared across requests).
+     *
+     * @example
+     * ```ts
+     * app.use(async (ctx, next) => {
+     *   ctx.locals.userId = "123";
+     *   return await next();
+     * });
+     * ```
+     */
+    locals: Record<string, unknown>;
+}
+//# 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;IACvB;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

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.5",
   "description": "HTTP routing and middleware for Bunary - a Bun-first backend framework inspired by Laravel",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,6 +37,10 @@
     "type": "git",
     "url": "https://github.com/bunary-dev/http.git"
   },
+  "homepage": "https://github.com/bunary-dev/http#readme",
+  "bugs": {
+    "url": "https://github.com/bunary-dev/http/issues"
+  },
   "engines": {
     "bun": ">=1.0.0"
   },