@middy/cloudformation-router 7.2.3 → 7.3.1

package/index.d.ts

@@ -24,4 +24,8 @@ declare function cloudformationRouterHandler(
 	options: Options | Route[],
 ): middy.MiddyfiedHandler<CloudFormationCustomResourceEvent, void>;
 
+export declare function cloudformationRouterValidateOptions(
+	options?: Record<string, unknown>,
+): void;
+
 export default cloudformationRouterHandler;

package/index.js

@@ -1,5 +1,7 @@
 // Copyright 2017 - 2026 will Farrell, Luciano Mammino, and Middy contributors.
 // SPDX-License-Identifier: MIT
+import { validateOptions } from "@middy/util";
+
 const defaults = {
 	routes: [],
 	notFoundResponse: ({ requestType }) => {
@@ -12,6 +14,47 @@ const defaults = {
 		throw err;
 	},
 };
+
+const requestTypes = ["Create", "Update", "Delete"];
+
+const optionSchema = {
+	type: "object",
+	properties: {
+		routes: {
+			type: "array",
+			items: {
+				type: "object",
+				required: ["requestType", "handler"],
+				properties: {
+					requestType: { type: "string", enum: requestTypes },
+					handler: { instanceof: "Function" },
+				},
+				additionalProperties: false,
+			},
+		},
+		notFoundResponse: { instanceof: "Function" },
+	},
+	additionalProperties: false,
+};
+
+export const cloudformationRouterValidateOptions = (options) => {
+	validateOptions("@middy/cloudformation-router", optionSchema, options);
+	const routes = options?.routes;
+	if (routes === undefined) return options;
+	const seen = new Set();
+	for (const { requestType } of routes) {
+		if (seen.has(requestType)) {
+			throw new Error("Duplicate route", {
+				cause: {
+					package: "@middy/cloudformation-router",
+					data: { requestType },
+				},
+			});
+		}
+		seen.add(requestType);
+	}
+	return options;
+};
 const cloudformationCustomResourceRouteHandler = (opts = {}) => {
 	let options;
 	if (Array.isArray(opts)) {
@@ -28,14 +71,11 @@ const cloudformationCustomResourceRouteHandler = (opts = {}) => {
 		routesStatic[requestType] = handler;
 	}
 
-	const requestTypes = {
-		Create: true,
-		Update: true,
-		Delete: true,
-	};
 	return (event, context, abort) => {
 		const { RequestType: requestType } = event;
-		if (!requestType || !Object.hasOwn(requestTypes, requestType)) {
+		// Schema `enum` only validates route config at setup; this guard
+		// validates the incoming AWS event shape at invocation time.
+		if (!requestType || !requestTypes.includes(requestType)) {
 			throw new Error(
 				`Unknown CloudFormation Custom Resource event format: 'RequestType' must be one of Create, Update, Delete. Received: ${requestType ?? "undefined"}`,
 				{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@middy/cloudformation-router",
-	"version": "7.2.3",
+	"version": "7.3.1",
 	"description": "CloudFormation Custom Response event router for the middy framework",
 	"type": "module",
 	"engines": {
@@ -17,9 +17,6 @@
 			"import": {
 				"types": "./index.d.ts",
 				"default": "./index.js"
-			},
-			"require": {
-				"default": "./index.js"
 			}
 		}
 	},
@@ -65,7 +62,7 @@
 		"url": "https://github.com/sponsors/willfarrell"
 	},
 	"devDependencies": {
-		"@middy/core": "7.2.3",
+		"@middy/core": "7.3.1",
 		"@types/aws-lambda": "^8.0.0",
 		"@types/node": "^22.0.0"
 	}