Add options to control whether to error on unexpected properties

.changeset/ninety-jeans-prove.md

@@ -0,0 +1,5 @@
+---
+"@openapi-generator-plus/typescript-express-passport-server-generator": minor
+---
+
+Add options to control whether to error on unexpected properties

templates/index.hbs

@@ -5,8 +5,11 @@ import { Express } from 'express'
 import {{identifier name}} from './api/{{identifier name}}'
 {{/each}}
 import * as t from './types'
+import { setValidationOptions } from './validation'
 
-export default function(app: Express, impl: t.ApiImplementation) {
+export default function(app: Express, impl: t.ApiImplementation, options?: t.ApiOptions) {
+	setValidationOptions(options)
+
 	{{#each groups}}
 	{{identifier name}}(app, impl.{{identifier name}})
 	{{/each}}

templates/indexTypes.hbs

@@ -9,3 +9,7 @@ export interface ApiImplementation {
 	{{identifier name}}: {{identifier name}}.{{className name}}Api
 	{{/each}}
 }
+
+export interface ApiOptions {
+	failOnUnknownProperties?: boolean
+}

templates/validation.hbs

@@ -2,10 +2,17 @@
 
 import { Express } from 'express'
 import { Api } from './models'
+import { ApiOptions } from './types'
 
 type FromJsonFunction<T> = (name: string, value: any) => T
 type MapOf<T> = { [name: string]: T }
 
+let __options: ApiOptions | undefined
+
+export function setValidationOptions(options: ApiOptions | undefined) {
+	__options = options
+}
+
 /**
  * A conditional type to convert an interface model to the equivalent JSON model.
  * We may represent dates as Date objects in our object model, but we must translate

templates/validationGeneric.hbs

@@ -88,11 +88,11 @@ export function model{{className nativeType.parentType}}FromJson(name: string, v
 	const result: {{nativeType}} = model{{className nativeType.parentType}}FromJsonContent(name, value, knownKeys)
 
 	/* Known keys */
-	// TODO if we don't ignore unknown properties
-	for (const key of Object.keys(value)) {
-		if (!knownKeys[key]) {
-			// throw `Unexpected key: ${key}`
-			console.warn(`Unexpected key in {{nativeType}}: ${key}`)
+	if (__options?.failOnUnknownProperties) {
+		for (const key of Object.keys(value)) {
+			if (!knownKeys[key]) {
+				throw `Unexpected key in {{nativeType}}: ${key}`
+			}
 		}
 	}
 
@@ -116,11 +116,11 @@ export function model{{className nativeType.parentType}}ToJson(name: string, val
 	const result: ToJson<{{nativeType}}> = model{{className nativeType.parentType}}ToJsonContent(name, value, knownKeys)
 
 	/* Known keys */
-	// TODO if we don't ignore unknown properties
-	for (const key of Object.keys(value)) {
-		if (!knownKeys[key]) {
-			// throw `Unexpected key: ${key}`
-			console.warn(`Unexpected key in {{nativeType}}: ${key}`)
+	if (__options?.failOnUnknownProperties) {
+		for (const key of Object.keys(value)) {
+			if (!knownKeys[key]) {
+				throw `Unexpected key in {{nativeType}}: ${key}`
+			}
 		}
 	}