@bunary/http 0.0.4 → 0.0.5

package/CHANGELOG.md

@@ -5,6 +5,46 @@ All notable changes to `@bunary/http` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.5] - 2026-01-28
+
+### Added
+
+- `RequestContext.locals` for per-request middleware state (isolated between concurrent requests)
+
+## [0.0.4] - 2026-01-26
+
+### Added
+
+- Optional route parameters using `:param?` syntax
+  - Routes can match with or without optional parameters
+  - Optional params are `undefined` in `ctx.params` when not provided
+  - Supports multiple optional parameters in a single route
+  - Works with route constraints
+- Comprehensive test suite for optional parameters
+
+## [0.0.3] - 2026-01-26
+
+### Added
+
+- Route Groups with `app.group()` method
+  - Prefix routes with shared path prefix
+  - Apply middleware to groups of routes
+  - Add name prefixes for named routes in groups
+  - Support nested groups
+- Named Routes with `.name()` method
+  - Assign names to routes for URL generation
+  - Generate URLs with `app.route(name, params)`
+  - Check route existence with `app.hasRoute(name)`
+  - List all routes with `app.getRoutes()`
+  - Support query string parameters in URL generation
+- Route Constraints with `.where()` method
+  - Validate route parameters with regex patterns
+  - Helper methods: `whereNumber()`, `whereAlpha()`, `whereAlphaNumeric()`, `whereUuid()`, `whereUlid()`, `whereIn()`
+  - Support string or RegExp patterns
+  - Multiple constraints per route
+  - Constraints work with optional parameters
+- Comprehensive test suites for groups, named routes, and constraints
+
 ## [0.0.2] - 2026-01-24
 
 ### Added

package/README.md

@@ -4,6 +4,10 @@ A lightweight, type-safe HTTP framework built exclusively for [Bun](https://bun.
 
 Part of the [Bunary](https://github.com/bunary-dev) ecosystem - a Bun-first backend platform inspired by Laravel.
 
+## Documentation
+
+Canonical documentation for this package lives in [`docs/index.md`](./docs/index.md).
+
 ## Features
 
 - 🚀 **Bun-native** - Uses `Bun.serve()` directly, no Node.js compatibility layer

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,SAAS,EAYT,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAmOrC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,SAAS,EAYT,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAoOrC"}

package/dist/index.js

@@ -327,7 +327,8 @@ function createApp() {
     const ctx = {
       request,
       params: match.params,
-      query: url.searchParams
+      query: url.searchParams,
+      locals: {}
     };
     try {
       const allMiddleware = getMiddlewareChain(match.route);

package/dist/types/requestContext.d.ts

@@ -18,5 +18,19 @@ export interface RequestContext {
     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

@@ -1 +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"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunary/http",
-  "version": "0.0.4",
+  "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"
   },