@basaltkit/express 1.2.1 → 1.3.0

package/dist/index.d.ts

@@ -8,6 +8,13 @@ export interface ExpressPluginOptions {
     routes?: BasaltRoute[];
     /** Bring your own Express app; otherwise one is created with `express.json()`. */
     app?: Express;
+    /**
+     * Serve the neutral JSON body (`NOT_FOUND_RESPONSE` from @basaltkit/http)
+     * for unmatched routes, identical across all adapters, instead of Express's
+     * HTML default. Default: true. Pass false to keep Express's own handling
+     * (e.g. when the app mounts its own catch-all after boot).
+     */
+    notFound?: boolean;
 }
 /**
  * Runs Basalt on Express. The same routes, enrichers, guards and edge plugins

package/dist/index.js

@@ -1,5 +1,5 @@
 import { Container, createToken, definePlugin, ensureMetadata } from '@basaltkit/core';
-import { HttpServerCollector, HTTP_SERVER, runRoute, toErrorResponse, isSseResponse, sseProducerOf, driveSse, SSE_HEADERS, } from '@basaltkit/http';
+import { NOT_FOUND_RESPONSE, HttpServerCollector, HTTP_SERVER, runRoute, toErrorResponse, isSseResponse, sseProducerOf, driveSse, SSE_HEADERS, } from '@basaltkit/http';
 import express, {} from 'express';
 export const EXPRESS = createToken('express');
 function toNeutralRequest(req) {
@@ -140,6 +140,14 @@ export function expressPlugin(options = {}) {
                             reply.send(result);
                     });
                 }
+                // Mounted last, so anything unmatched gets the neutral JSON 404
+                // instead of Express's HTML default.
+                if (options.notFound !== false) {
+                    app.use((_req, res) => {
+                        if (!res.headersSent)
+                            res.status(404).json(NOT_FOUND_RESPONSE);
+                    });
+                }
             });
             for (const definition of routes) {
                 metadata.add('http:routes', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basaltkit/express",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Express adapter for Basalt: run the same typed routes, enrichers and guards on Express that you would on Fastify or Hono.",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
   ],
   "dependencies": {
     "@basaltkit/core": "^1.1.2",
-    "@basaltkit/http": "^1.9.1"
+    "@basaltkit/http": "^1.10.0"
   },
   "peerDependencies": {
     "express": "^4.19.0 || ^5.0.0"