@jsenv/server 17.7.1 → 17.7.2

package/dist/client/route_inspector/route_inspector.html

@@ -853,6 +853,18 @@ main {
   font-weight: 700;
 }
 
+.route_also_method {
+  color: #fff;
+  text-shadow: 0 1px #0000001a;
+  background: var(--method-color);
+  border-radius: 3px;
+  margin-left: 6px;
+  padding: 3px 6px;
+  font-family: sans-serif;
+  font-size: 11px;
+  font-weight: 700;
+}
+
 .route_resource {
   word-break: break-word;
   margin-top: 0;
@@ -897,7 +909,7 @@ main {
   opacity: .85;
 }
 
-.route_details[data-forbidden] .route_method {
+.route_details[data-forbidden] .route_method, .route_details[data-forbidden] .route_also_method {
   opacity: .7;
   filter: grayscale(60%);
 }
@@ -1835,6 +1847,7 @@ const routesLoadingSignal = M$1(false);
       const RouteDetails = ({
         meta,
         method,
+        methods,
         resource,
         description,
         availableMediaTypes,
@@ -1858,6 +1871,10 @@ const routesLoadingSignal = M$1(false);
         if (selectedPackageName && packageName !== selectedPackageName) {
           return null;
         }
+        // what the router answers beyond the declared method (a GET route
+        // also answers HEAD); a "*" route answers everything, its chip says so
+        const alsoMethods =
+          method === "*" ? [] : methods.filter((m) => m !== method);
 
         return p$3`<details
             class="route_details"
@@ -1867,6 +1884,14 @@ const routesLoadingSignal = M$1(false);
           >
             <summary class="route_summary_container">
               <span class="route_method">${method}</span>
+              ${alsoMethods.map(
+                (alsoMethod) => p$3`<span
+                    class="route_also_method"
+                    style="--method-color: var(--method-${alsoMethod.toLowerCase()}-color)"
+                    title="Also answers ${alsoMethod}"
+                    >+${alsoMethod}</span
+                  >`,
+              )}
               <p class="route_resource">${resource}</p>
               ${method === "GET" && !forbidden
                 ? p$3`<a

package/dist/jsenv_server.js

@@ -6959,6 +6959,7 @@ const createRoute = ({
       }
       return {
         method,
+        methods,
         resource,
         description,
         availableMediaTypes,

package/docs/handling_requests.md

@@ -31,7 +31,7 @@ await startServer({
 | `GET /*`               | anything, with the path in `request.params[0]`                                                          |
 | `GET *`                | anything: a catch-all, put it last                                                                      |
 
-A `GET` route also answers `HEAD`: the response is built the same way and sent without its body.
+A `GET` route also answers `HEAD`: the response is built the same way and sent without its body. When building that body is costly, declare a `HEAD` route for the same resource before the `GET` one: it answers `HEAD` in its place.
 
 Only `*` widens a pattern. Routes are tried in order, so a route covering others (`GET /docs/*`, `GET *`) goes after them. `fetch` can be async; returning `null` or `undefined` declines the request and the next route is tried.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/server",
-  "version": "17.7.1",
+  "version": "17.7.2",
   "type": "module",
   "description": "A modern Node.js HTTP server with declarative routing, content negotiation, and WebSocket support",
   "repository": {

package/src/plugins/route_inspector/client/route_inspector.html

@@ -443,6 +443,17 @@
         background: var(--method-color);
         border-radius: 3px;
       }
+      .route_also_method {
+        margin-left: 6px;
+        padding: 3px 6px;
+        color: #fff;
+        font-weight: 700;
+        font-size: 11px;
+        font-family: sans-serif;
+        text-shadow: 0 1px 0 rgba(0, 0, 0, 0.1);
+        background: var(--method-color);
+        border-radius: 3px;
+      }
       .route_resource {
         margin-top: 0;
         margin-bottom: 0;
@@ -486,7 +497,8 @@
         border-color: var(--forbidden-border-color);
         opacity: 0.85;
       }
-      .route_details[data-forbidden] .route_method {
+      .route_details[data-forbidden] .route_method,
+      .route_details[data-forbidden] .route_also_method {
         opacity: 0.7;
         filter: grayscale(60%);
       }
@@ -1428,6 +1440,7 @@
       const RouteDetails = ({
         meta,
         method,
+        methods,
         resource,
         description,
         availableMediaTypes,
@@ -1451,6 +1464,10 @@
         if (selectedPackageName && packageName !== selectedPackageName) {
           return null;
         }
+        // what the router answers beyond the declared method (a GET route
+        // also answers HEAD); a "*" route answers everything, its chip says so
+        const alsoMethods =
+          method === "*" ? [] : methods.filter((m) => m !== method);
 
         return html`<details
             class="route_details"
@@ -1460,6 +1477,14 @@
           >
             <summary class="route_summary_container">
               <span class="route_method">${method}</span>
+              ${alsoMethods.map(
+                (alsoMethod) => html`<span
+                    class="route_also_method"
+                    style="--method-color: var(--method-${alsoMethod.toLowerCase()}-color)"
+                    title="Also answers ${alsoMethod}"
+                    >+${alsoMethod}</span
+                  >`,
+              )}
               <p class="route_resource">${resource}</p>
               ${method === "GET" && !forbidden
                 ? html`<a

package/src/router/router.js

@@ -766,6 +766,7 @@ const createRoute = ({
       }
       return {
         method,
+        methods,
         resource,
         description,
         availableMediaTypes,