hapi-terminator 0.2.0 → 0.3.0

package/README.md

@@ -108,14 +108,56 @@ server.route({
 await server.start();
 ```
 
+### Boolean Limits for Unregistered Routes
+
+You can use boolean values for `unregisteredLimit` to control unregistered route behavior:
+
+```typescript
+import Hapi from '@hapi/hapi';
+import terminatorPlugin, { type TerminatorOptions } from 'hapi-terminator';
+
+const server = Hapi.server({ port: 3000, host: '127.0.0.1' });
+
+// Reject all unregistered routes immediately
+await server.register({
+  plugin: terminatorPlugin,
+  options: {
+    registeredLimit: 1024 * 1024, // 1MB for registered routes
+    unregisteredLimit: true, // Immediately reject all unregistered routes
+  },
+});
+
+// This route will work normally
+server.route({
+  method: ['POST'],
+  path: '/api/data',
+  handler: () => ({ success: true }),
+});
+
+// Any request to unregistered routes (e.g., /unknown) will be rejected immediately
+await server.start();
+```
+
+You can also set `unregisteredLimit` to `false` to bypass payload size checks for unregistered routes:
+
+```typescript
+await server.register({
+  plugin: terminatorPlugin,
+  options: {
+    registeredLimit: 500 * 1024, // 500KB for registered routes
+    unregisteredLimit: false, // Bypass payload size checks for unregistered routes
+  },
+});
+```
+
 ## Configuration
 
 ### TerminatorOptions
 
-| Option              | Type     | Description                                                                                                   |
-| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
-| `registeredLimit`   | `number` | Maximum payload size in bytes for registered routes. Must be >= 0. Set to `null` or `undefined` to disable.   |
-| `unregisteredLimit` | `number` | Maximum payload size in bytes for unregistered routes. Must be >= 0. Set to `null` or `undefined` to disable. |
+| Option              | Type                | Description                                                                                                                                                                                                   |
+| ------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `registeredLimit`   | `number`            | Maximum payload size in bytes for registered routes. Must be >= 0. Set to `null` or `undefined` to disable.                                                                                                   |
+| `unregisteredLimit` | `number \| boolean` | Maximum payload size in bytes for unregistered routes. Must be >= 0. Set to `null` or `undefined` to disable. Set to `true` to reject all requests immediately. Set to `false` to bypass payload size checks. |
 
 ### TerminatorRouteOptions
 
@@ -131,6 +173,9 @@ You can configure per-route limits using the route options:
 - **Unregistered Routes**: When a payload exceeds the limit on an unregistered route, the socket is gracefully ended and a `404 Not Found` error is returned.
 - **Per-Route Limits**: Route-specific limits take precedence over global limits, allowing you to customize limits for individual routes.
 - **Disabled**: Set to `null` or `undefined` to disable termination for that category or route.
+- **Boolean Values for Unregistered Routes**:
+  - Set `unregisteredLimit` to `true` to immediately reject all unregistered route requests regardless of Content-Length (even 0 bytes).
+  - Set `unregisteredLimit` to `false` to bypass payload size checks for unregistered route requests (they will still receive 404 responses).
 
 ## How It Works
 

package/dist/index.d.ts

@@ -60,7 +60,7 @@ declare const TerminatorRouteOptionsSchema: z.ZodMiniOptional<z.ZodMiniNullable<
 }, z.core.$strip>>>;
 declare const TerminatorOptionsSchema: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
     registeredLimit: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
-    unregisteredLimit: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+    unregisteredLimit: z.ZodMiniUnion<readonly [z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>, z.ZodMiniBoolean<boolean>]>;
 }, z.core.$strip>>>;
 declare function register(server: Server, rawOptions: TerminatorOptions): Promise<void>;
 declare const _default: {

package/dist/index.js

@@ -8,9 +8,11 @@ const LIMIT_OPTION_NAMES = {
 const PACKAGE_NAME = 'hapi-terminator';
 assert(PACKAGE_NAME === pkg.name);
 export const plugin = { pkg, register };
-const LimitOptionShape = z.nullish(z.number().check(z.minimum(0)));
-const TerminatorRouteOptionsSchema = z.nullish(z.object({ [PACKAGE_NAME]: z.object({ limit: LimitOptionShape }) }));
-const TerminatorOptionsSchema = z.nullish(z.object({ registeredLimit: LimitOptionShape, unregisteredLimit: LimitOptionShape }));
+const TerminatorRouteOptionsSchema = z.nullish(z.object({ [PACKAGE_NAME]: z.object({ limit: z.nullish(z.number().check(z.minimum(0))) }) }));
+const TerminatorOptionsSchema = z.nullish(z.object({
+    registeredLimit: z.nullish(z.number().check(z.minimum(0))),
+    unregisteredLimit: z.union([z.nullish(z.number().check(z.minimum(0))), z.boolean()]),
+}));
 async function register(server, rawOptions) {
     const options = TerminatorOptionsSchema.parse(rawOptions);
     const routeOptionsCache = new Map();
@@ -66,6 +68,16 @@ function validateRoute(request, h, options) {
         if (limit == null) {
             return h.continue;
         }
+        if (limit === false) {
+            return h.continue;
+        }
+        if (limit === true) {
+            const result = response(0).takeover();
+            request.raw.res.once('finish', () => {
+                request.raw.req.socket.end();
+            });
+            return result;
+        }
         if (contentLength <= limit) {
             return h.continue;
         }

package/dist/package.json

@@ -3,7 +3,7 @@
     "main": "dist/index.js",
     "typings": "dist/index.d.ts",
     "type": "module",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "license": "MIT",
     "author": {
         "name": "Kamaal Farah"

package/package.json

@@ -3,7 +3,7 @@
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "MIT",
   "author": {
     "name": "Kamaal Farah"