@bunary/http 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -5,7 +5,27 @@ 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.1] - 2025-01-27
+## [0.0.2] - 2026-01-24
+
+### Added
+
+- Comprehensive middleware test suite (19 tests)
+- Middleware documentation in README with examples:
+  - Basic logging middleware
+  - Error handling middleware
+  - Authentication middleware pattern
+  - Middleware chain execution order
+
+### Verified
+
+- Middleware pipeline executes in registration order (FR-016)
+- `app.use(middleware)` adds middleware to pipeline (FR-015)
+- Middleware can call `next()` for chain continuation
+- Middleware can return early without calling `next()`
+- Middleware can catch and handle errors from `next()`
+- Middleware errors return 500 response
+
+## [0.0.1] - 2026-01-24
 
 ### Added
 

package/README.md

@@ -144,6 +144,77 @@ const data = await response.json();
 // { message: 'hi' }
 ```
 
+## Middleware
+
+Add middleware to handle cross-cutting concerns like logging, authentication, and error handling.
+
+### Basic Middleware
+
+```typescript
+// Logging middleware
+app.use(async (ctx, next) => {
+  const start = Date.now();
+  const result = await next();
+  console.log(`${ctx.request.method} ${new URL(ctx.request.url).pathname} - ${Date.now() - start}ms`);
+  return result;
+});
+```
+
+### Middleware Chain
+
+Middleware executes in registration order. Each middleware can:
+- Run code before calling `next()`
+- Call `next()` to continue the chain
+- Run code after `next()` returns
+- Return early without calling `next()`
+
+```typescript
+app
+  .use(async (ctx, next) => {
+    console.log('First - before');
+    const result = await next();
+    console.log('First - after');
+    return result;
+  })
+  .use(async (ctx, next) => {
+    console.log('Second - before');
+    const result = await next();
+    console.log('Second - after');
+    return result;
+  });
+
+// Output order: First-before, Second-before, handler, Second-after, First-after
+```
+
+### Error Handling Middleware
+
+```typescript
+app.use(async (ctx, next) => {
+  try {
+    return await next();
+  } catch (error) {
+    console.error('Error:', error);
+    return new Response(JSON.stringify({ error: error.message }), { 
+      status: 500,
+      headers: { 'Content-Type': 'application/json' }
+    });
+  }
+});
+```
+
+### Auth Middleware (Example)
+
+```typescript
+app.use(async (ctx, next) => {
+  const token = ctx.request.headers.get('Authorization');
+  if (!token) {
+    return new Response(JSON.stringify({ error: 'Unauthorized' }), { status: 401 });
+  }
+  // Validate token...
+  return await next();
+});
+```
+
 ## Error Handling
 
 Uncaught errors in handlers return a 500 response:

package/package.json

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