From e35a07c8ae3c31012b4d52ee2d895a254b4e57ce Mon Sep 17 00:00:00 2001
From: Duncan Beevers <duncan@dweebd.com>
Date: Sat, 1 Jun 2024 19:31:50 -0700
Subject: [PATCH] chore: apiSpec may be const literal (#854)

Co-authored-by: Carmine DiMascio <cdimascio@gmail.com>
---
 src/framework/types.ts      | 20 +++++++++++++++++++-
 test/default-export.spec.ts | 30 ++++++++++++++++--------------
 2 files changed, 35 insertions(+), 15 deletions(-)

diff --git a/src/framework/types.ts b/src/framework/types.ts
index 420f42dc..9d4d0c65 100644
--- a/src/framework/types.ts
+++ b/src/framework/types.ts
@@ -113,8 +113,26 @@ export type SerDesMap = {
   [format: string]: SerDes
 };
 
+type Primitive = undefined | null | boolean | string | number | Function
+
+type Immutable<T> =
+  T extends Primitive ? T :
+    T extends Array<infer U> ? ReadonlyArray<U> :
+      T extends Map<infer K, infer V> ? ReadonlyMap<K, V> : Readonly<T>
+
+type DeepImmutable<T> =
+  T extends Primitive ? T :
+    T extends Array<infer U> ? DeepImmutableArray<U> :
+      T extends Map<infer K, infer V> ? DeepImmutableMap<K, V> : DeepImmutableObject<T>
+
+interface DeepImmutableArray<T> extends ReadonlyArray<DeepImmutable<T>> {}
+interface DeepImmutableMap<K, V> extends ReadonlyMap<DeepImmutable<K>, DeepImmutable<V>> {}
+type DeepImmutableObject<T> = {
+  readonly [K in keyof T]: DeepImmutable<T[K]>
+}
+
 export interface OpenApiValidatorOpts {
-  apiSpec: OpenAPIV3.Document | string;
+  apiSpec: DeepImmutable<OpenAPIV3.Document> | string;
   validateApiSpec?: boolean;
   validateResponses?: boolean | ValidateResponseOpts;
   validateRequests?: boolean | ValidateRequestOpts;
diff --git a/test/default-export.spec.ts b/test/default-export.spec.ts
index 6b4cd2fc..cacff56d 100644
--- a/test/default-export.spec.ts
+++ b/test/default-export.spec.ts
@@ -4,6 +4,21 @@ import { expect } from 'chai';
 import * as request from 'supertest';
 import * as path from 'path';
 
+const schema = {
+  openapi: '3.0.0',
+  info: { version: '1.0.0', title: 'test bug OpenApiValidator' },
+  servers: [],
+  paths: {
+    '/': {
+      get: {
+        operationId: 'anything',
+        'x-eov-operation-handler': 'controller-with-default',
+        responses: { 200: { description: 'home api' } }
+      }
+    },
+  },
+} as const;
+
 describe('default export resolver', () => {
   let server = null;
   let app = express();
@@ -11,20 +26,7 @@ describe('default export resolver', () => {
   before(async () => {
     app.use(
       OpenApiValidator.middleware({
-        apiSpec: {
-          openapi: '3.0.0',
-          info: { version: '1.0.0', title: 'test bug OpenApiValidator' },
-          paths: {
-            '/': {
-              get: {
-                operationId: 'anything',
-                // @ts-ignore
-                'x-eov-operation-handler': 'controller-with-default',
-                responses: { 200: { description: 'home api' } }
-              }
-            },
-          },
-        },
+        apiSpec: schema,
         operationHandlers: path.join(__dirname, 'resources'),
       }),
     );