@b9g/http-errors 0.1.3 → 0.1.4

package/README.md

@@ -1,14 +1,14 @@
 # @b9g/http-errors
 
-Standard HTTP error responses with proper status codes and web platform Response objects.
+**Standard HTTP error responses for ServiceWorker applications. Returns proper Response objects with status codes, not thrown exceptions.**
 
 ## Features
 
-- **Standard HTTP Errors**: Pre-defined error classes for common HTTP status codes
-- **Web Platform Response**: Returns proper Response objects, not thrown exceptions
-- **Consistent API**: Uniform interface across all error types
+- **ServiceWorker Compatible**: Returns Response objects perfect for `event.respondWith()`
+- **Standard HTTP Status Codes**: Pre-defined functions for all common HTTP errors
+- **No Exceptions**: Functional approach - return errors, don't throw them
 - **TypeScript Support**: Full type definitions for all error classes
-- **Lightweight**: Minimal dependencies, works everywhere
+- **Universal**: Works in browsers, Node.js, Bun, and edge platforms
 
 ## Installation
 
@@ -130,9 +130,9 @@ router.get('/users/:id', async (request, context) => {
 ### Middleware Error Handling
 
 ```javascript
-router.use(async (request, context, next) => {
+router.use(async function* (request, context) {
   try {
-    return await next();
+    return yield request;
   } catch (error) {
     console.error('Request failed:', error);
     return InternalServerError('Something went wrong');
@@ -165,9 +165,48 @@ const duplicateError = Conflict('Email already exists', {
 });
 ```
 
+## Exports
+
+### Classes
+
+- `HTTPError` - Base HTTP error class (extends Error)
+- `NotHandled` - Special error for unhandled requests
+
+### Client Error Classes (4xx)
+
+- `BadRequest` (400)
+- `Unauthorized` (401)
+- `Forbidden` (403)
+- `NotFound` (404)
+- `MethodNotAllowed` (405)
+- `Conflict` (409)
+- `UnprocessableEntity` (422)
+- `TooManyRequests` (429)
+
+### Server Error Classes (5xx)
+
+- `InternalServerError` (500)
+- `NotImplemented` (501)
+- `BadGateway` (502)
+- `ServiceUnavailable` (503)
+- `GatewayTimeout` (504)
+
+### Functions
+
+- `createHTTPError(status, message?, options?)` - Create an HTTPError with a specific status code
+- `isHTTPError(value)` - Type guard to check if a value is an HTTPError
+
+### Types
+
+- `HTTPErrorOptions` - Options for HTTPError constructor
+
+### Default Export
+
+- `createHTTPError` - Factory function for creating HTTP errors
+
 ## API Reference
 
-### Error Functions
+### Error Classes
 
 All error functions follow the same signature:
 
@@ -259,7 +298,7 @@ router.post('/api/users', async (request) => {
 ```javascript
 import { Unauthorized, Forbidden } from '@b9g/http-errors';
 
-const authMiddleware = async (request, context, next) => {
+const authMiddleware = async function* (request, context) {
   const token = request.headers.get('authorization');
   
   if (!token) {
@@ -269,7 +308,7 @@ const authMiddleware = async (request, context, next) => {
   try {
     const user = await verifyToken(token);
     context.user = user;
-    return await next();
+    return yield request;
   } catch (error) {
     return Forbidden('Invalid or expired token');
   }

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@b9g/http-errors",
-  "version": "0.1.3",
-  "description": "HTTP error classes for web applications",
+  "version": "0.1.4",
+  "description": "Standard HTTP error responses for ServiceWorker applications. Returns proper Response objects with status codes, not thrown exceptions.",
   "keywords": [
     "http",
     "errors",
-    "web",
-    "status-codes"
+    "response",
+    "serviceworker",
+    "status-codes",
+    "web-standards",
+    "functional",
+    "shovel"
   ],
   "dependencies": {},
   "devDependencies": {

package/src/index.d.ts

@@ -35,10 +35,6 @@ export declare class HTTPError extends Error {
         expose: boolean;
         headers: Record<string, string>;
     };
-    /**
-     * Create a Response object from this error
-     */
-    toResponse(): Response;
 }
 /**
  * Special error for middleware fallthrough (not an HTTP error)

package/src/index.js

@@ -71,17 +71,6 @@ var HTTPError = class extends Error {
       headers: this.headers
     };
   }
-  /**
-   * Create a Response object from this error
-   */
-  toResponse() {
-    const body = this.expose ? this.message : STATUS_CODES[this.status];
-    return new Response(body, {
-      status: this.status,
-      statusText: STATUS_CODES[this.status],
-      headers: this.headers
-    });
-  }
 };
 var NotHandled = class extends Error {
   constructor(message = "Request not handled by middleware") {
@@ -90,7 +79,13 @@ var NotHandled = class extends Error {
   }
 };
 function isHTTPError(value) {
-  return value instanceof HTTPError || value instanceof Error && typeof value.status === "number" && typeof value.statusCode === "number" && value.status === value.statusCode;
+  if (value instanceof HTTPError)
+    return true;
+  if (!(value instanceof Error))
+    return false;
+  const hasStatus = "status" in value && typeof value.status === "number";
+  const hasStatusCode = "statusCode" in value && typeof value.statusCode === "number";
+  return hasStatus && hasStatusCode && value.status === value.statusCode;
 }
 function createHTTPError(status, message, options) {
   return new HTTPError(status, message, options);