add super hack to support undeclared polymorphic adapter fields (#84 )

i forgot to bump the version :((((
allow custom type overrides (#83 )
2021-08-15 01:02:23 +00:00 · 2021-08-12 20:40:09 -05:00 · 2021-08-12 21:38:48 -04:00 · 2021-08-12 22:32:18 +00:00 · 2021-07-25 10:48:14 -04:00 · 2021-07-22 22:38:39 -04:00
61 changed files with 1985 additions and 442 deletions
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@ -2,6 +2,9 @@ name: Publish to GitHub Packages
 on:
  push:
    branches: [ main ]
+env:
+  ORG_GRADLE_PROJECT_signingKey: ${{ secrets.SONATYPE_SIGNING_KEY }}
+  ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.SONATYPE_SIGNING_PASSWORD }}
 jobs:
  publish:
    runs-on: ubuntu-latest
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@ -4,8 +4,11 @@ on:
    types:
      - prereleased
      - released
+env:
+  ORG_GRADLE_PROJECT_signingKey: ${{ secrets.SONATYPE_SIGNING_KEY }}
+  ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.SONATYPE_SIGNING_PASSWORD }}
 jobs:
-  publish:
+  publish-to-github:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
@ -23,8 +26,22 @@ jobs:
        run: ./gradlew publishAllPublicationsToGithubPackagesRepository -Prelease=true
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-#      - name: Publish packages to Nexus
-#        run: ./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository -Prelease=true
-#        env:
-#          SONATYPE_USER: ${{ secrets.SONATYPE_USER }}
-#          SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }}
+  publish-to-nexus:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v2
+        with:
+          distribution: 'adopt'
+          java-version: '11'
+      - name: Cache Gradle packages
+        uses: actions/cache@v2
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}
+          restore-keys: ${{ runner.os }}-gradle
+      - name: Publish packages to Github
+        run: ./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository -Prelease=true
+        env:
+          ORG_GRADLE_PROJECT_sonatypeUsername: ${{ secrets.SONATYPE_USER }}
+          ORG_GRADLE_PROJECT_sonatypePassword: ${{ secrets.SONATYPE_PASSWORD }}
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,5 +1,70 @@
 # Changelog

+## [1.7.0] - August 14th, 2021
+
+### Added
+
+- Added ability to inject an emergency `UndeclaredField` in the event of certain polymorphic serializers and such
+
+## [1.6.0] - August 12th, 2021
+
+### Added
+
+- Ability to add custom type schema overrides for edge case types.
+
+## [1.5.1] - August 12th, 2021
+
+### Changed
+
+- Fixed bug where polymorphic types were not being rendered correctly when part of collections and maps
+
+## [1.5.0] - July 25th, 2021
+
+### Changed
+
+- Added support for BigInteger and BigDecimal in response types
+
+## [1.4.0] - July 22nd, 2021
+
+### Changed
+
+- Decreased jvmTarget version from 11 to 1.8
+
+## [1.3.0] - June 4th, 2021
+
+### Changed
+
+- Explicitly encode JSON object by default
+
+## [1.2.3] - June 3rd, 2021
+
+### Added
+
+- Updates showing/explaining serializer agnostic approach
+
+## [1.2.2] - May 23rd, 2021
+
+This is just to get my repo back to normal now that I have confirmed sonatype publish is happening
+
+## [1.2.0] - May 23rd, 2021
+
+### Added
+
+- Finally, successfully pushed to Maven Central!!!
+
+## [1.1.0] - May 19th, 2021
+
+### Added
+
+- Support for sealed classes 🔥
+- Support for generic classes ☄️
+
+## [1.0.1] - May 10th, 2021
+
+### Changed
+
+- a word to sweep my rude commit message to Nexus under the rug
+
 ## [1.0.0] - May 9th, 2021

 ### Added
--- a/README.md
+++ b/README.md
@ -1,5 +1,7 @@
 # Kompendium

+[![version](https://img.shields.io/maven-central/v/io.bkbn/kompendium-core?style=flat-square)](https://search.maven.org/search?q=io.bkbn%20kompendium)
+
 ## What is Kompendium

 Kompendium is intended to be a minimally invasive OpenApi Specification generator for [Ktor](https://ktor.io). 
@ -8,8 +10,26 @@ supplement with Kompendium code in order to generate the appropriate spec.

 ## How to install

-Kompendium uses GitHub packages as its repository.  Installing with Gradle is pretty painless.  In your `build.gradle.kts`
-add the following 
+Kompendium publishes all releases to Maven Central.  As such, using the stable version of `Kompendium` is as simple 
+as declaring it as an implementation dependency in your `build.gradle.kts`
+
+```kotlin
+repositories {
+  mavenCentral()
+}
+
+dependencies {
+  // other (less cool) dependencies
+  implementation("io.bkbn:kompendium-core:latest")
+  implementation("io.bkbn:kompendium-auth:latest")
+  implementation("io.bkbn:kompendium-swagger-ui:latest")
+}
+```
+
+The last two dependencies are optional.
+
+If you want to get a little spicy 🤠 every merge of Kompendium is published to the GitHub package registry.  Pulling 
+from GitHub is slightly more involved, but such is the price you pay for bleeding edge fake data generation.  

 ```kotlin
 // 1 Setup a helper function to import any Github Repository Package
@ -17,7 +37,7 @@ add the following
 fun RepositoryHandler.github(packageUrl: String) = maven { 
    name = "GithubPackages"
    url = uri(packageUrl)
-    credentials { // TODO Not sure this is necessary for public repositories?
+    credentials {
      username = java.lang.System.getenv("GITHUB_USER")
      password = java.lang.System.getenv("GITHUB_TOKEN")
    } 
@ -30,7 +50,7 @@ repositories {

 // 3 Add the package like any normal dependency
 dependencies { 
-    implementation("org.leafygreens:kompendium-core:0.1.0-SNAPSHOT")
+    implementation("io.bkbn:kompendium-core:1.0.0")
 }

 ```
@ -76,6 +96,29 @@ The intended purpose of `KompendiumField` is to offer field level overrides such
 The purpose of `KompendiumParam` is to provide supplemental information needed to properly assign the type of parameter 
 (cookie, header, query, path) as well as other parameter-level metadata. 

+### Undeclared Field
+
+There is also a final `UndeclaredField` annotation.  This should be used only in an absolutely emergency.  This annotation
+will allow you to inject a _single_ undeclared field that will be included as part of the schema. 
+
+Due to limitations in using repeated annotations, this can only be used once per class
+
+This is a complete hack, and is included for odd scenarios like kotlinx serialization polymorphic adapters that expect a 
+`type` field in order to perform their analysis.  
+
+Use this _only_ when **all** else fails
+
+### Polymorphism
+
+Speaking of polymorphism... out of the box, Kompendium has support for sealed classes and interfaces. At runtime, it will build a mapping of all available sub-classes
+and build a spec that takes `anyOf` the implementations.  This is currently a weak point of the entire library, and 
+suggestions on better implementations are welcome 🤠
+
+### Serialization
+
+Under the hood, Kompendium uses Jackson to serialize the final api spec.  However, this implementation detail 
+does not leak to the actual API, meaning that users are free to choose the serialization library of their choice.  
+
 ## Examples

 The full source code can be found in the `kompendium-playground` module. Here is a simple get endpoint example 
@ -185,6 +228,25 @@ routing {
 }
 ```

+## Custom Type Overrides
+
+Kompendium does its best to analyze types and to generate an OpenAPI format accordingly. However, there are certain 
+classes that just don't play nice with the standard reflection analysis that Kompendium performs.
+Should you encounter a data type that Kompendium cannot comprehend, you will need to 
+add it explicitly.  For example, adding the Joda Time `DateTime` object would be as simple as the following 
+
+```kotlin
+  Kompendium.addCustomTypeSchema(DateTime::class, FormatSchema("date-time", "string"))
+```
+
+Since `Kompendium` is an object, this needs to be declared once, ahead of the actual API instantiation.  This way, this 
+type override can be cached ahead of reflection.  Kompendium will then match all instances of this type and return the 
+specified schema.  
+
+So how do you know a type can and cannot be inferred?  The safe bet is that it can be.  So go ahead and give it a shot. 
+However, in the very odd scenario (almost always having to do with date/time libraries 😤) where it can't, you can rest
+safely knowing that you have the option to inject a custom override should you need to.
+
 ## Limitations

 ### Kompendium as a singleton
@ -201,10 +263,8 @@ parity with the OpenAPI feature spec, nor does it have all-of-the nice to have f
 should have.  There are several outstanding features that have been added to the
 [V2 Milestone](https://github.com/bkbnio/kompendium/milestone/2).  Among others, this includes 

- Polymorphic support
 - AsyncAPI Integration
 - Field Validation
- MavenCentral Release

 If you have a feature that you would like to see implemented that is not on this list, or discover a 🐞, please open 
 an issue [here](https://github.com/bkbnio/kompendium/issues/new)
--- a/build.gradle.kts
+++ b/build.gradle.kts
@ -1,6 +1,11 @@
+import com.adarshr.gradle.testlogger.TestLoggerExtension
+import com.adarshr.gradle.testlogger.theme.ThemeType
+import io.gitlab.arturbosch.detekt.extensions.DetektExtension
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
+
 plugins {
-  id("org.jetbrains.kotlin.jvm") version "1.4.32" apply false
-  id("io.gitlab.arturbosch.detekt") version "1.16.0-RC2" apply false
+  id("org.jetbrains.kotlin.jvm") version "1.5.0" apply false
+  id("io.gitlab.arturbosch.detekt") version "1.17.0-RC3" apply false
  id("com.adarshr.test-logger") version "3.0.0" apply false
  id("io.github.gradle-nexus.publish-plugin") version "1.1.0" apply true
 }
@ -9,7 +14,7 @@ allprojects {
  group = "io.bkbn"
  version = run {
    val baseVersion =
-      project.findProperty("project.version") ?: error("project.version must be set in gradle.properties")
+      project.findProperty("project.version") ?: error("project.version needs to be set in gradle.properties")
    when ((project.findProperty("release") as? String)?.toBoolean()) {
      true -> baseVersion
      else -> "$baseVersion-SNAPSHOT"
@ -26,14 +31,14 @@ allprojects {
  apply(plugin = "com.adarshr.test-logger")
  apply(plugin = "idea")

-  tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
+  tasks.withType<KotlinCompile>().configureEach {
    kotlinOptions {
-      jvmTarget = "11"
+      jvmTarget = "1.8"
    }
  }

-  configure<com.adarshr.gradle.testlogger.TestLoggerExtension> {
-    setTheme("standard")
+  configure<TestLoggerExtension> {
+    theme = ThemeType.MOCHA
    setLogLevel("lifecycle")
    showExceptions = true
    showStackTraces = true
@ -51,23 +56,22 @@ allprojects {
    showFailedStandardStreams = true
  }

-  configure<io.gitlab.arturbosch.detekt.extensions.DetektExtension> {
-    toolVersion = "1.16.0-RC2"
+  configure<DetektExtension> {
+    toolVersion = "1.17.0-RC3"
    config = files("${rootProject.projectDir}/detekt.yml")
    buildUponDefaultConfig = true
  }

  configure<JavaPluginExtension> {
    withSourcesJar()
+    withJavadocJar()
  }
 }

 nexusPublishing {
  repositories {
    sonatype {
-      username.set(System.getenv("SONATYPE_USER"))
-      password.set(System.getenv("SONATYPE_PASSWORD"))
-      nexusUrl.set(uri("https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/"))
+      nexusUrl.set(uri("https://s01.oss.sonatype.org/service/local/"))
      snapshotRepositoryUrl.set(uri("https://s01.oss.sonatype.org/content/repositories/snapshots/"))
    }
  }
--- a/gradle.properties
+++ b/gradle.properties
@ -1,5 +1,5 @@
 # Kompendium
-project.version=1.0.0
+project.version=1.7.0
 # Kotlin
 kotlin.code.style=official
 # Gradle
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@ -1,6 +1,8 @@
 [versions]
 kotlin = "1.4.32"
 ktor = "1.5.3"
+kotlinx-serialization = "1.2.1"
+jackson-kotlin = "2.12.0"
 slf4j = "1.7.30"
 logback = "1.2.3"
 swagger-ui = "3.47.1"
@ -10,11 +12,17 @@ swagger-ui = "3.47.1"
 ktor-server-core = { group = "io.ktor", name = "ktor-server-core", version.ref = "ktor" }
 ktor-server-netty = { group = "io.ktor", name = "ktor-server-netty", version.ref = "ktor" }
 ktor-jackson = { group = "io.ktor", name = "ktor-jackson", version.ref = "ktor" }
+ktor-serialization = { group = "io.ktor", name = "ktor-serialization", version.ref = "ktor" }
 ktor-html-builder = { group = "io.ktor", name = "ktor-html-builder", version.ref = "ktor" }
 ktor-auth-lib = { group = "io.ktor", name = "ktor-auth", version.ref = "ktor" }
 ktor-auth-jwt = { group = "io.ktor", name = "ktor-auth-jwt", version.ref = "ktor" }
 ktor-webjars = { group = "io.ktor", name = "ktor-webjars", version.ref = "ktor" }

+# Serialization
+jackson-module-kotlin = { group = "com.fasterxml.jackson.module", name = "jackson-module-kotlin", version.ref = "jackson-kotlin" }
+kotlinx-serialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json", version.ref = "kotlinx-serialization" }
+
+
 # Logging
 slf4j = { group = "org.slf4j", name = "slf4j-api", version.ref = "slf4j" }
 logback-classic = { group = "ch.qos.logback", name = "logback-classic", version.ref = "logback" }
@ -23,7 +31,10 @@ logback-core = { group = "ch.qos.logback", name = "logback-core", version.ref =
 # webjars
 webjars-swagger-ui = { group = "org.webjars", name = "swagger-ui", version.ref = "swagger-ui" }

+# Testing
+ktor-server-test-host = { group = "io.ktor", name = "ktor-server-test-host", version.ref = "ktor" }
+
 [bundles]
-ktor = [ "ktor-server-core", "ktor-server-netty", "ktor-jackson", "ktor-html-builder" ]
-ktorAuth = [ "ktor-auth-lib", "ktor-auth-jwt" ]
-logging = [ "slf4j", "logback-classic", "logback-core" ]
+ktor = ["ktor-server-core", "ktor-server-netty", "ktor-html-builder"]
+ktorAuth = ["ktor-auth-lib", "ktor-auth-jwt"]
+logging = ["slf4j", "logback-classic", "logback-core"]
--- a/kompendium-auth/build.gradle.kts
+++ b/kompendium-auth/build.gradle.kts
@ -1,6 +1,7 @@
 plugins {
  `java-library`
  `maven-publish`
+  signing
 }

 dependencies {
@ -10,14 +11,16 @@ dependencies {
  implementation(libs.bundles.ktorAuth)
  implementation(projects.kompendiumCore)

+  testImplementation(libs.ktor.jackson)
  testImplementation("org.jetbrains.kotlin:kotlin-test")
  testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
-  testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.12.0")
-  testImplementation("io.ktor:ktor-server-test-host:1.5.3")
+  testImplementation(libs.jackson.module.kotlin)
+  testImplementation(libs.ktor.server.test.host)
 }

 java {
  withSourcesJar()
+  withJavadocJar()
 }

 publishing {
@ -35,6 +38,41 @@ publishing {
    create<MavenPublication>("kompendium") {
      from(components["kotlin"])
      artifact(tasks.sourcesJar)
+      artifact(tasks.javadocJar)
+      groupId = project.group.toString()
+      artifactId = project.name.toLowerCase()
+      version = project.version.toString()
+
+      pom {
+        name.set("Kompendium")
+        description.set("A minimally invasive OpenAPI spec generator for Ktor")
+        url.set("https://github.com/bkbnio/Kompendium")
+        licenses {
+          license {
+            name.set("MIT License")
+            url.set("https://mit-license.org/")
+          }
+        }
+        developers {
+          developer {
+            id.set("bkbnio")
+            name.set("Ryan Brink")
+            email.set("admin@bkbn.io")
+          }
+        }
+        scm {
+          connection.set("scm:git:git://github.com/bkbnio/Kompendium.git")
+          developerConnection.set("scm:git:ssh://github.com/bkbnio/Kompendium.git")
+          url.set("https://github.com/bkbnio/Kompendium.git")
+        }
+      }
    }
  }
 }
+
+signing {
+  val signingKey: String? by project
+  val signingPassword: String? by project
+  useInMemoryPgpKeys(signingKey, signingPassword)
+  sign(publishing.publications)
+}
--- a/kompendium-auth/src/test/resources/notarized_basic_authenticated_get.json
+++ b/kompendium-auth/src/test/resources/notarized_basic_authenticated_get.json
@ -20,8 +20,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -51,16 +51,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : {
--- a/kompendium-auth/src/test/resources/notarized_jwt_authenticated_get.json
+++ b/kompendium-auth/src/test/resources/notarized_jwt_authenticated_get.json
@ -20,8 +20,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -51,16 +51,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : {
--- a/kompendium-auth/src/test/resources/notarized_jwt_custom_header_authenticated_get.json
+++ b/kompendium-auth/src/test/resources/notarized_jwt_custom_header_authenticated_get.json
@ -20,8 +20,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -51,16 +51,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : {
--- a/kompendium-auth/src/test/resources/notarized_jwt_custom_scheme_authenticated_get.json
+++ b/kompendium-auth/src/test/resources/notarized_jwt_custom_scheme_authenticated_get.json
@ -20,8 +20,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -51,16 +51,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : {
--- a/kompendium-auth/src/test/resources/notarized_multiple_jwt_authenticated_get.json
+++ b/kompendium-auth/src/test/resources/notarized_multiple_jwt_authenticated_get.json
@ -20,8 +20,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -52,16 +52,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : {
--- a/kompendium-core/build.gradle.kts
+++ b/kompendium-core/build.gradle.kts
@ -1,20 +1,25 @@
 plugins {
  `java-library`
  `maven-publish`
+  signing
 }

 dependencies {
  implementation(platform("org.jetbrains.kotlin:kotlin-bom"))
  implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8")
+  implementation(libs.jackson.module.kotlin)
  implementation(libs.bundles.ktor)
  testImplementation("org.jetbrains.kotlin:kotlin-test")
  testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
-  testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.12.0")
-  testImplementation("io.ktor:ktor-server-test-host:1.5.3")
+  testImplementation(libs.ktor.serialization)
+  testImplementation(libs.kotlinx.serialization.json)
+  testImplementation(libs.ktor.jackson)
+  testImplementation(libs.ktor.server.test.host)
 }

 java {
  withSourcesJar()
+  withJavadocJar()
 }

 publishing {
@ -32,6 +37,41 @@ publishing {
    create<MavenPublication>("kompendium") {
      from(components["kotlin"])
      artifact(tasks.sourcesJar)
+      artifact(tasks.javadocJar)
+      groupId = project.group.toString()
+      artifactId = project.name.toLowerCase()
+      version = project.version.toString()
+
+      pom {
+        name.set("Kompendium")
+        description.set("A minimally invasive OpenAPI spec generator for Ktor")
+        url.set("https://github.com/bkbnio/Kompendium")
+        licenses {
+          license {
+            name.set("MIT License")
+            url.set("https://mit-license.org/")
+          }
+        }
+        developers {
+          developer {
+            id.set("bkbnio")
+            name.set("Ryan Brink")
+            email.set("admin@bkbn.io")
+          }
+        }
+        scm {
+          connection.set("scm:git:git://github.com/bkbnio/Kompendium.git")
+          developerConnection.set("scm:git:ssh://github.com/bkbnio/Kompendium.git")
+          url.set("https://github.com/bkbnio/Kompendium.git")
+        }
+      }
    }
  }
 }
+
+signing {
+  val signingKey: String? by project
+  val signingPassword: String? by project
+  useInMemoryPgpKeys(signingKey, signingPassword)
+  sign(publishing.publications)
+}
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Kompendium.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Kompendium.kt
@ -4,8 +4,10 @@ import io.bkbn.kompendium.models.meta.ErrorMap
 import io.bkbn.kompendium.models.meta.SchemaMap
 import io.bkbn.kompendium.models.oas.OpenApiSpec
 import io.bkbn.kompendium.models.oas.OpenApiSpecInfo
+import io.bkbn.kompendium.models.oas.TypedSchema
 import io.bkbn.kompendium.path.CorePathCalculator
 import io.bkbn.kompendium.path.PathCalculator
+import kotlin.reflect.KClass

 /**
 * Maintains all state for the Kompendium library
@ -31,4 +33,8 @@ object Kompendium {
    )
    cache = emptyMap()
  }
+
+  fun addCustomTypeSchema(clazz: KClass<*>, schema: TypedSchema) {
+    cache = cache.plus(clazz.simpleName!! to schema)
+  }
 }
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/KompendiumPreFlight.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/KompendiumPreFlight.kt
@ -1,7 +1,9 @@
 package io.bkbn.kompendium

 import io.ktor.routing.Route
+import kotlin.reflect.KClass
 import kotlin.reflect.KType
+import kotlin.reflect.full.createType
 import kotlin.reflect.typeOf

 /**
@ -21,13 +23,11 @@ object KompendiumPreFlight {
  inline fun <reified TParam : Any, reified TReq : Any, reified TResp : Any> methodNotarizationPreFlight(
    block: (KType, KType, KType) -> Route
  ): Route {
-    Kompendium.cache = Kontent.generateKontent<TResp>(Kompendium.cache)
-    Kompendium.cache = Kontent.generateKontent<TReq>(Kompendium.cache)
-    Kompendium.cache = Kontent.generateParameterKontent<TParam>(Kompendium.cache)
-    Kompendium.openApiSpec.components.schemas.putAll(Kompendium.cache)
    val requestType = typeOf<TReq>()
    val responseType = typeOf<TResp>()
    val paramType = typeOf<TParam>()
+    addToCache(paramType, requestType, responseType)
+    Kompendium.openApiSpec.components.schemas.putAll(Kompendium.cache)
    return block.invoke(paramType, requestType, responseType)
  }

@ -38,13 +38,19 @@ object KompendiumPreFlight {
   * @param block The function to execute, provided type information of the parameters above
   */
  @OptIn(ExperimentalStdlibApi::class)
-  inline fun <reified TErr: Throwable, reified TResp : Any> errorNotarizationPreFlight(
+  inline fun <reified TErr : Throwable, reified TResp : Any> errorNotarizationPreFlight(
    block: (KType, KType) -> Unit
  ) {
-    Kompendium.cache = Kontent.generateKontent<TResp>(Kompendium.cache)
-    Kompendium.openApiSpec.components.schemas.putAll(Kompendium.cache)
    val errorType = typeOf<TErr>()
    val responseType = typeOf<TResp>()
+    addToCache(typeOf<Unit>(), typeOf<Unit>(), responseType)
+    Kompendium.openApiSpec.components.schemas.putAll(Kompendium.cache)
    return block.invoke(errorType, responseType)
  }
+
+  fun addToCache(paramType: KType, requestType: KType, responseType: KType) {
+    Kompendium.cache = Kontent.generateKontent(requestType, Kompendium.cache)
+    Kompendium.cache = Kontent.generateKontent(responseType, Kompendium.cache)
+    Kompendium.cache = Kontent.generateParameterKontent(paramType, Kompendium.cache)
+  }
 }
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Kontent.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Kontent.kt
@ -1,25 +1,32 @@
 package io.bkbn.kompendium

-import java.util.UUID
-import kotlin.reflect.KClass
-import kotlin.reflect.KType
-import kotlin.reflect.full.isSubclassOf
-import kotlin.reflect.full.memberProperties
-import kotlin.reflect.jvm.javaField
-import kotlin.reflect.typeOf
+import io.bkbn.kompendium.annotations.UndeclaredField
 import io.bkbn.kompendium.models.meta.SchemaMap
+import io.bkbn.kompendium.models.oas.AnyOfReferencedSchema
 import io.bkbn.kompendium.models.oas.ArraySchema
 import io.bkbn.kompendium.models.oas.DictionarySchema
 import io.bkbn.kompendium.models.oas.EnumSchema
 import io.bkbn.kompendium.models.oas.FormatSchema
 import io.bkbn.kompendium.models.oas.ObjectSchema
+import io.bkbn.kompendium.models.oas.OpenApiSpecComponentSchema
 import io.bkbn.kompendium.models.oas.ReferencedSchema
 import io.bkbn.kompendium.models.oas.SimpleSchema
 import io.bkbn.kompendium.util.Helpers.COMPONENT_SLUG
 import io.bkbn.kompendium.util.Helpers.genericNameAdapter
 import io.bkbn.kompendium.util.Helpers.getReferenceSlug
+import io.bkbn.kompendium.util.Helpers.getSimpleSlug
 import io.bkbn.kompendium.util.Helpers.logged
+import java.util.UUID
+import kotlin.reflect.KClass
+import kotlin.reflect.KType
+import kotlin.reflect.full.createType
+import kotlin.reflect.full.isSubclassOf
+import kotlin.reflect.full.memberProperties
+import kotlin.reflect.jvm.javaField
+import kotlin.reflect.typeOf
 import org.slf4j.LoggerFactory
+import java.math.BigDecimal
+import java.math.BigInteger

 /**
 * Responsible for generating the schema map that is used to power all object references across the API Spec.
@ -42,6 +49,34 @@ object Kontent {
    return generateKTypeKontent(kontentType, cache)
  }

+  /**
+   * Analyzes a [KType] for its top-level and any nested schemas, and adds them to a [SchemaMap], if provided
+   * @param type [KType] to analyze
+   * @param cache Existing schema map to append to
+   * @return an updated schema map containing all type information for [KType] type
+   */
+  fun generateKontent(
+    type: KType,
+    cache: SchemaMap = emptyMap()
+  ): SchemaMap {
+    var newCache = cache
+    gatherSubTypes(type).forEach {
+      newCache = generateKTypeKontent(it, newCache)
+    }
+    return newCache
+  }
+
+  private fun gatherSubTypes(type: KType): List<KType> {
+    val classifier = type.classifier as KClass<*>
+    return if (classifier.isSealed) {
+      classifier.sealedSubclasses.map {
+        it.createType(type.arguments)
+      }
+    } else {
+      listOf(type)
+    }
+  }
+
  /**
   * Analyze a type [T], but filters out the top-level type
   * @param T type to analyze
@ -57,6 +92,20 @@ object Kontent {
      .filterNot { (slug, _) -> slug == (kontentType.classifier as KClass<*>).simpleName }
  }

+  /**
+   * Analyze a type but filters out the top-level type
+   * @param type to analyze
+   * @param cache Existing schema map to append to
+   * @return an updated schema map containing all type information for [T]
+   */
+  fun generateParameterKontent(
+    type: KType,
+    cache: SchemaMap = emptyMap()
+  ): SchemaMap {
+    return generateKTypeKontent(type, cache)
+      .filterNot { (slug, _) -> slug == (type.classifier as KClass<*>).simpleName }
+  }
+
  /**
   * Recursively fills schema map depending on [KType] classifier
   * @param type [KType] to parse
@ -76,11 +125,13 @@ object Kontent {
      String::class -> cache.plus(clazz.simpleName!! to SimpleSchema("string"))
      Boolean::class -> cache.plus(clazz.simpleName!! to SimpleSchema("boolean"))
      UUID::class -> cache.plus(clazz.simpleName!! to FormatSchema("uuid", "string"))
+      BigDecimal::class -> cache.plus(clazz.simpleName!! to FormatSchema("double", "number"))
+      BigInteger::class -> cache.plus(clazz.simpleName!! to FormatSchema("int64", "integer"))
      else -> when {
        clazz.isSubclassOf(Collection::class) -> handleCollectionType(type, clazz, cache)
        clazz.isSubclassOf(Enum::class) -> handleEnumType(clazz, cache)
        clazz.isSubclassOf(Map::class) -> handleMapType(type, clazz, cache)
-        else -> handleComplexType(clazz, cache)
+        else -> handleComplexType(type, clazz, cache)
      }
    }
  }
@ -90,30 +141,82 @@ object Kontent {
   * @param clazz Class of the object to analyze
   * @param cache Existing schema map to append to
   */
-  private fun handleComplexType(clazz: KClass<*>, cache: SchemaMap): SchemaMap =
-    when (cache.containsKey(clazz.simpleName)) {
+  private fun handleComplexType(type: KType, clazz: KClass<*>, cache: SchemaMap): SchemaMap {
+    // This needs to be simple because it will be stored under it's appropriate reference component implicitly
+    val slug = type.getSimpleSlug()
+    // Only analyze if component has not already been stored in the cache
+    return when (cache.containsKey(slug)) {
      true -> {
-        logger.debug("Cache already contains ${clazz.simpleName}, returning cache untouched")
+        logger.debug("Cache already contains $slug, returning cache untouched")
        cache
      }
      false -> {
-        logger.debug("${clazz.simpleName} was not found in cache, generating now")
+        logger.debug("$slug was not found in cache, generating now")
        var newCache = cache
+        // Grabs any type parameters as a zip with the corresponding type argument
+        val typeMap = clazz.typeParameters.zip(type.arguments).toMap()
+        // associates each member with a Pair of prop name to property schema
        val fieldMap = clazz.memberProperties.associate { prop ->
          logger.debug("Analyzing $prop in class $clazz")
+          // Grab the field of the current property
          val field = prop.javaField?.type?.kotlin ?: error("Unable to parse field type from $prop")
          logger.debug("Detected field $field")
+          // Yoinks any generic types from the type map should the field be a generic
+          val yoinkBaseType = if (typeMap.containsKey(prop.returnType.classifier)) {
+            logger.debug("Generic type detected")
+            typeMap[prop.returnType.classifier]?.type!!
+          } else {
+            prop.returnType
+          }
+          // converts the base type to a class
+          val yoinkedClassifier = yoinkBaseType.classifier as KClass<*>
+          // in the event of a sealed class, grab all sealed subclasses and create a type from the base args
+          val yoinkedTypes = if (yoinkedClassifier.isSealed) {
+            yoinkedClassifier.sealedSubclasses.map { it.createType(yoinkBaseType.arguments) }
+          } else {
+            listOf(yoinkBaseType)
+          }
+          // if the most up-to-date cache does not contain the content for this field, generate it and add to cache
          if (!newCache.containsKey(field.simpleName)) {
            logger.debug("Cache was missing ${field.simpleName}, adding now")
-            newCache = generateKTypeKontent(prop.returnType, newCache)
+            yoinkedTypes.forEach {
+              newCache = generateKTypeKontent(it, newCache)
+            }
+          }
+          // TODO This in particular is worthy of a refactor... just not very well written
+          // builds the appropriate property schema based on the property return type
+          val propSchema = if (typeMap.containsKey(prop.returnType.classifier)) {
+            if (yoinkedClassifier.isSealed) {
+              val refs = yoinkedClassifier.sealedSubclasses
+                .map { it.createType(yoinkBaseType.arguments) }
+                .map { ReferencedSchema(it.getReferenceSlug()) }
+              AnyOfReferencedSchema(refs)
+            } else {
+              ReferencedSchema(typeMap[prop.returnType.classifier]?.type!!.getReferenceSlug())
+            }
+          } else {
+            if (yoinkedClassifier.isSealed) {
+              val refs = yoinkedClassifier.sealedSubclasses
+                .map { it.createType(yoinkBaseType.arguments) }
+                .map { ReferencedSchema(it.getReferenceSlug()) }
+              AnyOfReferencedSchema(refs)
+            } else {
+              ReferencedSchema(field.getReferenceSlug(prop))
+            }
          }
-          val propSchema = ReferencedSchema(field.getReferenceSlug(prop))
          Pair(prop.name, propSchema)
        }
-        logger.debug("${clazz.simpleName} contains $fieldMap")
-        val schema = ObjectSchema(fieldMap)
-        logger.debug("${clazz.simpleName} schema: $schema")
-        newCache.plus(clazz.simpleName!! to schema)
+        logger.debug("Looking for undeclared fields")
+        val undeclaredFieldMap = clazz.annotations.filterIsInstance<UndeclaredField>().associate {
+          val undeclaredType = it.clazz.createType()
+          newCache = generateKontent(undeclaredType, newCache)
+          it.field to ReferencedSchema(undeclaredType.getReferenceSlug())
+        }
+        logger.debug("$slug contains $fieldMap")
+        val schema = ObjectSchema(fieldMap.plus(undeclaredFieldMap))
+        logger.debug("$slug schema: $schema")
+        newCache.plus(slug to schema)
+      }
    }
  }

@ -140,11 +243,20 @@ object Kontent {
    if (keyType?.classifier != String::class) {
      error("Invalid Map $type: OpenAPI dictionaries must have keys of type String")
    }
-    val valClassName = (valType?.classifier as KClass<*>).simpleName
+    val valClass = valType?.classifier as KClass<*>
+    val valClassName = valClass.simpleName
    val referenceName = genericNameAdapter(type, clazz)
-    val valueReference = ReferencedSchema("$COMPONENT_SLUG/$valClassName")
+    val valueReference = when (valClass.isSealed) {
+      true -> {
+        val subTypes = gatherSubTypes(valType)
+        AnyOfReferencedSchema(subTypes.map {
+          ReferencedSchema(("$COMPONENT_SLUG/${it.getSimpleSlug()}"))
+        })
+      }
+      false -> ReferencedSchema("$COMPONENT_SLUG/$valClassName")
+    }
    val schema = DictionarySchema(additionalProperties = valueReference)
-    val updatedCache = generateKTypeKontent(valType, cache)
+    val updatedCache = generateKontent(valType, cache)
    return updatedCache.plus(referenceName to schema)
  }

@ -160,9 +272,17 @@ object Kontent {
    val collectionClass = collectionType.classifier as KClass<*>
    logger.debug("Obtained collection class: $collectionClass")
    val referenceName = genericNameAdapter(type, clazz)
-    val valueReference = ReferencedSchema("${COMPONENT_SLUG}/${collectionClass.simpleName}")
+    val valueReference = when (collectionClass.isSealed) {
+      true -> {
+        val subTypes = gatherSubTypes(collectionType)
+        AnyOfReferencedSchema(subTypes.map {
+          ReferencedSchema(("$COMPONENT_SLUG/${it.getSimpleSlug()}"))
+        })
+      }
+      false -> ReferencedSchema("${COMPONENT_SLUG}/${collectionClass.simpleName}")
+    }
    val schema = ArraySchema(items = valueReference)
-    val updatedCache = generateKTypeKontent(collectionType, cache)
+    val updatedCache = generateKontent(collectionType, cache)
    return updatedCache.plus(referenceName to schema)
  }
 }
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/MethodParser.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/MethodParser.kt
@ -1,20 +1,11 @@
 package io.bkbn.kompendium

-import java.util.UUID
-import kotlin.reflect.KClass
-import kotlin.reflect.KParameter
-import kotlin.reflect.KProperty
-import kotlin.reflect.KType
-import kotlin.reflect.full.createType
-import kotlin.reflect.full.findAnnotation
-import kotlin.reflect.full.memberProperties
-import kotlin.reflect.full.primaryConstructor
-import kotlin.reflect.jvm.javaField
 import io.bkbn.kompendium.annotations.KompendiumParam
 import io.bkbn.kompendium.models.meta.MethodInfo
 import io.bkbn.kompendium.models.meta.RequestInfo
 import io.bkbn.kompendium.models.meta.ResponseInfo
 import io.bkbn.kompendium.models.oas.ExampleWrapper
+import io.bkbn.kompendium.models.oas.OpenApiAnyOf
 import io.bkbn.kompendium.models.oas.OpenApiSpecMediaType
 import io.bkbn.kompendium.models.oas.OpenApiSpecParameter
 import io.bkbn.kompendium.models.oas.OpenApiSpecPathItemOperation
@ -25,6 +16,17 @@ import io.bkbn.kompendium.models.oas.OpenApiSpecResponse
 import io.bkbn.kompendium.util.Helpers
 import io.bkbn.kompendium.util.Helpers.getReferenceSlug
 import io.bkbn.kompendium.util.Helpers.getSimpleSlug
+import java.util.Locale
+import java.util.UUID
+import kotlin.reflect.KClass
+import kotlin.reflect.KParameter
+import kotlin.reflect.KProperty
+import kotlin.reflect.KType
+import kotlin.reflect.full.createType
+import kotlin.reflect.full.findAnnotation
+import kotlin.reflect.full.memberProperties
+import kotlin.reflect.full.primaryConstructor
+import kotlin.reflect.jvm.javaField

 /**
 * The MethodParser is responsible for converting route metadata and types into an OpenAPI compatible data class.
@ -106,7 +108,7 @@ object MethodParser {
      else -> {
        OpenApiSpecRequest(
          description = requestInfo.description,
-          content = resolveContent(requestInfo.mediaTypes, requestInfo.examples) ?: mapOf()
+          content = resolveContent(this, requestInfo.mediaTypes, requestInfo.examples) ?: mapOf()
        )
      }
    }
@ -123,7 +125,7 @@ object MethodParser {
      else -> {
        val specResponse = OpenApiSpecResponse(
          description = responseInfo.description,
-          content = resolveContent(responseInfo.mediaTypes, responseInfo.examples)
+          content = resolveContent(this, responseInfo.mediaTypes, responseInfo.examples)
        )
        Pair(responseInfo.status.value, specResponse)
      }
@ -131,20 +133,31 @@ object MethodParser {

  /**
   * Generates MediaTypes along with any examples provided
-   * @receiver [KType] Type of the object
+   * @param type [KType] Type of the object
   * @param mediaTypes list of acceptable http media types
   * @param examples Mapping of named examples of valid bodies.
   * @return Named mapping of media types.
   */
-  private fun <F> KType.resolveContent(
+  private fun <F> resolveContent(
+    type: KType,
    mediaTypes: List<String>,
    examples: Map<String, F>
  ): Map<String, OpenApiSpecMediaType<F>>? {
-    return if (this != Helpers.UNIT_TYPE && mediaTypes.isNotEmpty()) {
+    val classifier = type.classifier as KClass<*>
+    return if (type != Helpers.UNIT_TYPE && mediaTypes.isNotEmpty()) {
      mediaTypes.associateWith {
-        val ref = getReferenceSlug()
+        val schema = if (classifier.isSealed) {
+          val refs = classifier.sealedSubclasses
+            .map { it.createType(type.arguments) }
+            .map { it.getReferenceSlug() }
+            .map { OpenApiSpecReferenceObject(it) }
+          OpenApiAnyOf(refs)
+        } else {
+          val ref = type.getReferenceSlug()
+          OpenApiSpecReferenceObject(ref)
+        }
        OpenApiSpecMediaType(
-          schema = OpenApiSpecReferenceObject(ref),
+          schema = schema,
          examples = examples.mapValues { (_, v) -> ExampleWrapper(v) }.ifEmpty { null }
        )
      }
@ -153,7 +166,7 @@ object MethodParser {

  /**
   * Parses a type for all parameter information.  All fields in the receiver
-   * must be annotated with [org.leafygreens.kompendium.annotations.KompendiumParam].
+   * must be annotated with [io.bkbn.kompendium.annotations.KompendiumParam].
   * @receiver type
   * @return list of valid parameter specs as detailed by the [KType] members
   * @throws [IllegalStateException] if the class could not be parsed properly
@ -170,7 +183,7 @@ object MethodParser {
      val defaultValue = getDefaultParameterValue(clazz, prop)
      OpenApiSpecParameter(
        name = prop.name,
-        `in` = anny.type.name.toLowerCase(),
+        `in` = anny.type.name.lowercase(Locale.getDefault()),
        schema = schema.addDefault(defaultValue),
        description = anny.description.ifBlank { null },
        required = !prop.returnType.isMarkedNullable
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Notarized.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/Notarized.kt
@ -27,7 +27,7 @@ object Notarized {
  /**
   * Notarization for an HTTP GET request
   * @param TParam The class containing all parameter fields.
-   * Each field must be annotated with @[org.leafygreens.kompendium.annotations.KompendiumField]
+   * Each field must be annotated with @[io.bkbn.kompendium.annotations.KompendiumField]
   * @param TResp Class detailing the expected API response
   * @param info Route metadata
   */
@ -45,7 +45,7 @@ object Notarized {
  /**
   * Notarization for an HTTP POST request
   * @param TParam The class containing all parameter fields.
-   * Each field must be annotated with @[org.leafygreens.kompendium.annotations.KompendiumField]
+   * Each field must be annotated with @[io.bkbn.kompendium.annotations.KompendiumField]
   * @param TReq Class detailing the expected API request body
   * @param TResp Class detailing the expected API response
   * @param info Route metadata
@ -64,7 +64,7 @@ object Notarized {
  /**
   * Notarization for an HTTP Delete request
   * @param TParam The class containing all parameter fields.
-   * Each field must be annotated with @[org.leafygreens.kompendium.annotations.KompendiumField]
+   * Each field must be annotated with @[io.bkbn.kompendium.annotations.KompendiumField]
   * @param TReq Class detailing the expected API request body
   * @param TResp Class detailing the expected API response
   * @param info Route metadata
@ -84,7 +84,7 @@ object Notarized {
  /**
   * Notarization for an HTTP POST request
   * @param TParam The class containing all parameter fields.
-   * Each field must be annotated with @[org.leafygreens.kompendium.annotations.KompendiumField]
+   * Each field must be annotated with @[io.bkbn.kompendium.annotations.KompendiumField]
   * @param TResp Class detailing the expected API response
   * @param info Route metadata
   */
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/annotations/UndeclaredField.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/annotations/UndeclaredField.kt
@ -0,0 +1,8 @@
+package io.bkbn.kompendium.annotations
+
+import kotlin.reflect.KClass
+
+@Retention(AnnotationRetention.RUNTIME)
+@Target(AnnotationTarget.CLASS)
+@Repeatable
+annotation class UndeclaredField(val field: String, val clazz: KClass<*>)
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecComponentSchema.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecComponentSchema.kt
@ -3,6 +3,7 @@ package io.bkbn.kompendium.models.oas
 sealed class OpenApiSpecComponentSchema(open val default: Any? = null) {

  fun addDefault(default: Any?): OpenApiSpecComponentSchema = when (this) {
+    is AnyOfReferencedSchema -> error("Cannot add default to anyOf reference")
    is ReferencedSchema -> this.copy(default = default)
    is ObjectSchema -> this.copy(default = default)
    is DictionarySchema -> this.copy(default = default)
@ -17,6 +18,7 @@ sealed class OpenApiSpecComponentSchema(open val default: Any? = null) {
 sealed class TypedSchema(open val type: String, override val default: Any? = null) : OpenApiSpecComponentSchema(default)

 data class ReferencedSchema(val `$ref`: String, override val default: Any? = null) : OpenApiSpecComponentSchema(default)
+data class AnyOfReferencedSchema(val anyOf: List<ReferencedSchema>) : OpenApiSpecComponentSchema()

 data class ObjectSchema(
  val properties: Map<String, OpenApiSpecComponentSchema>,
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecMediaType.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecMediaType.kt
@ -1,7 +1,7 @@
 package io.bkbn.kompendium.models.oas

 data class OpenApiSpecMediaType<T>(
-  val schema: OpenApiSpecReferenceObject,
+  val schema: OpenApiSpecReferencable,
  val examples: Map<String, ExampleWrapper<T>>? = null
 )

--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecReferencable.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/models/oas/OpenApiSpecReferencable.kt
@ -1,15 +1,16 @@
 package io.bkbn.kompendium.models.oas

-sealed class OpenApiSpecReferencable
+sealed interface OpenApiSpecReferencable

-class OpenApiSpecReferenceObject(val `$ref`: String) : OpenApiSpecReferencable()
+data class OpenApiAnyOf(val anyOf: List<OpenApiSpecReferenceObject>) : OpenApiSpecReferencable
+data class OpenApiSpecReferenceObject(val `$ref`: String) : OpenApiSpecReferencable

 data class OpenApiSpecResponse<T>(
    val description: String? = null,
    val headers: Map<String, OpenApiSpecReferencable>? = null,
    val content: Map<String, OpenApiSpecMediaType<T>>? = null,
    val links: Map<String, OpenApiSpecReferencable>? = null
-) : OpenApiSpecReferencable()
+) : OpenApiSpecReferencable

 data class OpenApiSpecParameter(
  val name: String,
@ -21,10 +22,10 @@ data class OpenApiSpecParameter(
  val allowEmptyValue: Boolean? = null,
  val style: String? = null,
  val explode: Boolean? = null
-) : OpenApiSpecReferencable()
+) : OpenApiSpecReferencable

 data class OpenApiSpecRequest<T>(
    val description: String?,
    val content: Map<String, OpenApiSpecMediaType<T>>,
    val required: Boolean = false
-) : OpenApiSpecReferencable()
+) : OpenApiSpecReferencable
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/routes/OpenApiRoute.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/routes/OpenApiRoute.kt
@ -1,20 +1,26 @@
 package io.bkbn.kompendium.routes

+import com.fasterxml.jackson.annotation.JsonInclude
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.databind.SerializationFeature
+import io.bkbn.kompendium.models.oas.OpenApiSpec
 import io.ktor.application.call
-import io.ktor.response.respond
+import io.ktor.response.respondText
 import io.ktor.routing.Routing
 import io.ktor.routing.get
 import io.ktor.routing.route
-import io.bkbn.kompendium.models.oas.OpenApiSpec

 /**
 * Provides an out-of-the-box route to return the generated [OpenApiSpec]
 * @param oas spec that is returned
 */
 fun Routing.openApi(oas: OpenApiSpec) {
+  val om = ObjectMapper()
+    .setSerializationInclusion(JsonInclude.Include.NON_NULL)
+    .enable(SerializationFeature.INDENT_OUTPUT)
  route("/openapi.json") {
    get {
-      call.respond(oas)
+      call.respondText { om.writeValueAsString(oas) }
    }
  }
 }
--- a/kompendium-core/src/main/kotlin/io/bkbn/kompendium/util/Helpers.kt
+++ b/kompendium-core/src/main/kotlin/io/bkbn/kompendium/util/Helpers.kt
@ -1,5 +1,6 @@
 package io.bkbn.kompendium.util

+import io.bkbn.kompendium.util.Helpers.getReferenceSlug
 import java.lang.reflect.ParameterizedType
 import kotlin.reflect.KClass
 import kotlin.reflect.KProperty
@ -16,27 +17,6 @@ object Helpers {

  val UNIT_TYPE by lazy { Unit::class.createType() }

-  /**
-   * Simple extension function that will take a [Pair] and place it (if absent) into a [MutableMap].
-   *
-   * @receiver [MutableMap]
-   * @param pair to add to map
-   */
-  fun <K, V> MutableMap<K, V>.putPairIfAbsent(pair: Pair<K, V>) = putIfAbsent(pair.first, pair.second)
-
-  /**
-   * Simple extension function that will convert a list with two items into a [Pair]
-   * @receiver [List]
-   * @return [Pair]
-   * @throws [IllegalArgumentException] when the list size is not exactly two
-   */
-  fun <T> List<T>.toPair(): Pair<T, T> {
-    if (this.size != 2) {
-      throw IllegalArgumentException("List is not of length 2!")
-    }
-    return Pair(this[0], this[1])
-  }
-
  /**
   * Higher order function that takes a map of names to objects and will log their state ahead of function invocation
   * along with the result of the function invocation
@ -53,6 +33,11 @@ object Helpers {
    else -> simpleName ?: error("Could not determine simple name for $this")
  }

+  fun KType.getSimpleSlug(): String = when {
+    this.arguments.isNotEmpty() -> genericNameAdapter(this, classifier as KClass<*>)
+    else -> (classifier as KClass<*>).simpleName ?: error("Could not determine simple name for $this")
+  }
+
  fun KType.getReferenceSlug(): String = when {
    arguments.isNotEmpty() -> "$COMPONENT_SLUG/${genericNameAdapter(this, classifier as KClass<*>)}"
    else -> "$COMPONENT_SLUG/${(classifier as KClass<*>).simpleName}"
--- a/kompendium-core/src/test/kotlin/io/bkbn/kompendium/KompendiumTest.kt
+++ b/kompendium-core/src/test/kotlin/io/bkbn/kompendium/KompendiumTest.kt
@ -18,8 +18,11 @@ import io.bkbn.kompendium.routes.openApi
 import io.bkbn.kompendium.routes.redoc
 import io.bkbn.kompendium.util.TestHelpers.getFileSnapshot
 import io.bkbn.kompendium.util.complexType
-import io.bkbn.kompendium.util.configModule
+import io.bkbn.kompendium.util.jacksonConfigModule
 import io.bkbn.kompendium.util.emptyGet
+import io.bkbn.kompendium.util.genericPolymorphicResponse
+import io.bkbn.kompendium.util.genericPolymorphicResponseMultipleImpls
+import io.bkbn.kompendium.util.kotlinxConfigModule
 import io.bkbn.kompendium.util.nestedUnderRootModule
 import io.bkbn.kompendium.util.nonRequiredParamsGet
 import io.bkbn.kompendium.util.notarizedDeleteModule
@ -29,12 +32,18 @@ import io.bkbn.kompendium.util.notarizedGetWithNotarizedException
 import io.bkbn.kompendium.util.notarizedPostModule
 import io.bkbn.kompendium.util.notarizedPutModule
 import io.bkbn.kompendium.util.pathParsingTestModule
+import io.bkbn.kompendium.util.polymorphicCollectionResponse
+import io.bkbn.kompendium.util.polymorphicInterfaceResponse
+import io.bkbn.kompendium.util.polymorphicMapResponse
+import io.bkbn.kompendium.util.polymorphicResponse
 import io.bkbn.kompendium.util.primitives
 import io.bkbn.kompendium.util.returnsList
 import io.bkbn.kompendium.util.rootModule
+import io.bkbn.kompendium.util.simpleGenericResponse
 import io.bkbn.kompendium.util.statusPageModule
 import io.bkbn.kompendium.util.statusPageMultiExceptions
 import io.bkbn.kompendium.util.trailingSlash
+import io.bkbn.kompendium.util.undeclaredType
 import io.bkbn.kompendium.util.withDefaultParameter
 import io.bkbn.kompendium.util.withExamples

@ -53,7 +62,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized Get records all expected information`() {
    withTestApplication({
-      configModule()
+      kotlinxConfigModule()
      docs()
      notarizedGetModule()
    }) {
@ -69,7 +78,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized Get does not interrupt the pipeline`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedGetModule()
    }) {
@ -85,7 +94,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized Post records all expected information`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedPostModule()
    }) {
@ -101,7 +110,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized post does not interrupt the pipeline`() {
    withTestApplication({
-      configModule()
+      kotlinxConfigModule()
      docs()
      notarizedPostModule()
    }) {
@ -117,7 +126,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized Put records all expected information`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedPutModule()
    }) {
@ -134,7 +143,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized put does not interrupt the pipeline`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedPutModule()
    }) {
@ -150,7 +159,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized delete records all expected information`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedDeleteModule()
    }) {
@ -166,7 +175,7 @@ internal class KompendiumTest {
  @Test
  fun `Notarized delete does not interrupt the pipeline`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedDeleteModule()
    }) {
@ -181,7 +190,7 @@ internal class KompendiumTest {
  @Test
  fun `Path parser stores the expected path`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      pathParsingTestModule()
    }) {
@ -197,7 +206,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize the root route`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      rootModule()
    }) {
@ -213,7 +222,7 @@ internal class KompendiumTest {
  @Test
  fun `Can call the root route`() {
    withTestApplication({
-      configModule()
+      kotlinxConfigModule()
      docs()
      rootModule()
    }) {
@ -229,7 +238,7 @@ internal class KompendiumTest {
  @Test
  fun `Nested under root module does not append trailing slash`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      nestedUnderRootModule()
    }) {
@ -245,7 +254,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize a trailing slash route`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      trailingSlash()
    }) {
@ -261,7 +270,7 @@ internal class KompendiumTest {
  @Test
  fun `Can call a trailing slash route`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      trailingSlash()
    }) {
@ -277,7 +286,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize a complex type`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      complexType()
    }) {
@ -293,7 +302,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize primitives`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      primitives()
    }) {
@ -309,7 +318,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize a top level list response`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      returnsList()
    }) {
@ -325,7 +334,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize route with no request params and no response body`() {
    withTestApplication({
-      configModule()
+      kotlinxConfigModule()
      docs()
      emptyGet()
    }) {
@ -341,7 +350,7 @@ internal class KompendiumTest {
  @Test
  fun `Can notarize route with non-required params`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      nonRequiredParamsGet()
    }) {
@ -357,7 +366,7 @@ internal class KompendiumTest {
  @Test
  fun `Generates the expected redoc`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      returnsList()
    }) {
@ -374,7 +383,7 @@ internal class KompendiumTest {
  fun `Generates additional responses when passed a throwable`() {
    withTestApplication({
      statusPageModule()
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedGetWithNotarizedException()
    }) {
@ -391,7 +400,7 @@ internal class KompendiumTest {
  fun `Generates additional responses when passed multiple throwables`() {
    withTestApplication({
      statusPageMultiExceptions()
-      configModule()
+      jacksonConfigModule()
      docs()
      notarizedGetWithMultipleThrowables()
    }) {
@ -407,7 +416,7 @@ internal class KompendiumTest {
  @Test
  fun `Can generate example response and request bodies`() {
    withTestApplication({
-      configModule()
+      kotlinxConfigModule()
      docs()
      withExamples()
    }) {
@ -423,7 +432,7 @@ internal class KompendiumTest {
  @Test
  fun `Can generate a default parameter value`() {
    withTestApplication({
-      configModule()
+      jacksonConfigModule()
      docs()
      withDefaultParameter()
    }) {
@ -436,6 +445,133 @@ internal class KompendiumTest {
    }
  }

+  @Test
+  fun `Can generate a polymorphic response type`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      polymorphicResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("polymorphic_response.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can generate a collection with polymorphic response type`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      polymorphicCollectionResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("polymorphic_list_response.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can generate a map with a polymorphic response type`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      polymorphicMapResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("polymorphic_map_response.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can generate a polymorphic response from a sealed interface`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      polymorphicInterfaceResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("sealed_interface_response.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can generate a response type with a generic type`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      simpleGenericResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("generic_response.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can generate a polymorphic response type with generics`() {
+    withTestApplication({
+      jacksonConfigModule()
+      docs()
+      genericPolymorphicResponse()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("polymorphic_response_with_generics.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Absolute Psycho Inheritance Test`() {
+    withTestApplication({
+      kotlinxConfigModule()
+      docs()
+      genericPolymorphicResponseMultipleImpls()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("crazy_polymorphic_example.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }
+
+  @Test
+  fun `Can add an undeclared field`() {
+    withTestApplication({
+      kotlinxConfigModule()
+      docs()
+      undeclaredType()
+    }) {
+      // do
+      val json = handleRequest(HttpMethod.Get, "/openapi.json").response.content
+
+      // expect
+      val expected = getFileSnapshot("undeclared_field.json").trim()
+      assertEquals(expected, json, "The received json spec should match the expected content")
+    }
+  }

  private val oas = Kompendium.openApiSpec.copy(
    info = OpenApiSpecInfo(
--- a/kompendium-core/src/test/kotlin/io/bkbn/kompendium/KontentTest.kt
+++ b/kompendium-core/src/test/kotlin/io/bkbn/kompendium/KontentTest.kt
@ -13,15 +13,7 @@ import io.bkbn.kompendium.models.oas.DictionarySchema
 import io.bkbn.kompendium.models.oas.FormatSchema
 import io.bkbn.kompendium.models.oas.ObjectSchema
 import io.bkbn.kompendium.models.oas.ReferencedSchema
-import io.bkbn.kompendium.util.ComplexRequest
-import io.bkbn.kompendium.util.TestInvalidMap
-import io.bkbn.kompendium.util.TestNestedModel
-import io.bkbn.kompendium.util.TestSimpleModel
-import io.bkbn.kompendium.util.TestSimpleWithEnumList
-import io.bkbn.kompendium.util.TestSimpleWithEnums
-import io.bkbn.kompendium.util.TestSimpleWithList
-import io.bkbn.kompendium.util.TestSimpleWithMap
-import io.bkbn.kompendium.util.TestWithUUID
+import io.bkbn.kompendium.util.*

@ExperimentalStdlibApi
 internal class KontentTest {
@ -45,6 +37,18 @@ internal class KontentTest {
    assertEquals(FormatSchema("int64", "integer"), result["Long"])
  }

+  @Test
+  fun `Object with BigDecimal and BigInteger types`() {
+    // do
+    val result = generateKontent<TestBigNumberModel>()
+
+    // expect
+    assertEquals(3, result.count())
+    assertTrue { result.containsKey(TestBigNumberModel::class.simpleName) }
+    assertEquals(FormatSchema("double", "number"), result["BigDecimal"])
+    assertEquals(FormatSchema("int64", "integer"), result["BigInteger"])
+  }
+
  @Test
  fun `Objects reference their base types in the cache`() {
    // do
--- a/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestModels.kt
+++ b/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestModels.kt
@ -4,9 +4,14 @@ import java.util.UUID
 import io.bkbn.kompendium.annotations.KompendiumField
 import io.bkbn.kompendium.annotations.KompendiumParam
 import io.bkbn.kompendium.annotations.ParamType
+import io.bkbn.kompendium.annotations.UndeclaredField
+import java.math.BigDecimal
+import java.math.BigInteger

 data class TestSimpleModel(val a: String, val b: Int)

+data class TestBigNumberModel(val a: BigDecimal, val b: BigInteger)
+
 data class TestNestedModel(val inner: TestSimpleModel)

 data class TestSimpleWithEnums(val a: String, val b: SimpleEnum)
@ -37,6 +42,8 @@ data class TestRequest(

 data class TestResponse(val c: String)

+data class TestGeneric<T>(val messy: String, val potato: T)
+
 data class TestCreatedResponse(val id: Int, val c: String)

 data class ComplexRequest(
@ -72,3 +79,27 @@ data class OptionalParams(
  @KompendiumParam(ParamType.QUERY) val required: String,
  @KompendiumParam(ParamType.QUERY) val notRequired: String?
 )
+
+sealed class FlibbityGibbit
+
+data class SimpleGibbit(val a: String) : FlibbityGibbit()
+data class ComplexGibbit(val b: String, val c: Int) : FlibbityGibbit()
+
+sealed interface SlammaJamma
+
+data class OneJamma(val a: Int) : SlammaJamma
+data class AnothaJamma(val b: Float) : SlammaJamma
+//data class InsaneJamma(val c: SlammaJamma) : SlammaJamma // 👀
+
+sealed interface Flibbity<T>
+
+data class Gibbity<T>(val a: T): Flibbity<T>
+data class Bibbity<T>(val b: String, val f: T) : Flibbity<T>
+
+enum class Hehe {
+  HAHA,
+  HOHO
+}
+
+@UndeclaredField("nowYouDont", Hehe::class)
+data class Mysterious(val nowYouSeeMe: String)
--- a/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestModules.kt
+++ b/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestModules.kt
@ -2,6 +2,14 @@ package io.bkbn.kompendium.util

 import com.fasterxml.jackson.annotation.JsonInclude
 import com.fasterxml.jackson.databind.SerializationFeature
+import io.bkbn.kompendium.Notarized.notarizedDelete
+import io.bkbn.kompendium.Notarized.notarizedException
+import io.bkbn.kompendium.Notarized.notarizedGet
+import io.bkbn.kompendium.Notarized.notarizedPost
+import io.bkbn.kompendium.Notarized.notarizedPut
+import io.bkbn.kompendium.models.meta.MethodInfo
+import io.bkbn.kompendium.models.meta.RequestInfo
+import io.bkbn.kompendium.models.meta.ResponseInfo
 import io.ktor.application.Application
 import io.ktor.application.call
 import io.ktor.application.install
@ -13,16 +21,9 @@ import io.ktor.response.respond
 import io.ktor.response.respondText
 import io.ktor.routing.route
 import io.ktor.routing.routing
-import io.bkbn.kompendium.Notarized.notarizedDelete
-import io.bkbn.kompendium.Notarized.notarizedException
-import io.bkbn.kompendium.Notarized.notarizedGet
-import io.bkbn.kompendium.Notarized.notarizedPost
-import io.bkbn.kompendium.Notarized.notarizedPut
-import io.bkbn.kompendium.models.meta.MethodInfo
-import io.bkbn.kompendium.models.meta.RequestInfo
-import io.bkbn.kompendium.models.meta.ResponseInfo
+import io.ktor.serialization.json

-fun Application.configModule() {
+fun Application.jacksonConfigModule() {
  install(ContentNegotiation) {
    jackson {
      enable(SerializationFeature.INDENT_OUTPUT)
@ -31,9 +32,20 @@ fun Application.configModule() {
  }
 }

+fun Application.kotlinxConfigModule() {
+  install(ContentNegotiation) {
+    json()
+  }
+}
+
 fun Application.statusPageModule() {
  install(StatusPages) {
-    notarizedException<Exception, ExceptionResponse>(info = ResponseInfo(HttpStatusCode.BadRequest, "Bad Things Happened")) {
+    notarizedException<Exception, ExceptionResponse>(
+      info = ResponseInfo(
+        HttpStatusCode.BadRequest,
+        "Bad Things Happened"
+      )
+    ) {
      call.respond(HttpStatusCode.BadRequest, ExceptionResponse("Why you do dis?"))
    }
  }
@ -41,10 +53,17 @@ fun Application.statusPageModule() {

 fun Application.statusPageMultiExceptions() {
  install(StatusPages) {
-    notarizedException<AccessDeniedException, Unit>(info = ResponseInfo(HttpStatusCode.Forbidden, "New API who dis?")) {
+    notarizedException<AccessDeniedException, Unit>(
+      info = ResponseInfo(HttpStatusCode.Forbidden, "New API who dis?")
+    ) {
      call.respond(HttpStatusCode.Forbidden)
    }
-    notarizedException<Exception, ExceptionResponse>(info = ResponseInfo(HttpStatusCode.BadRequest, "Bad Things Happened")) {
+    notarizedException<Exception, ExceptionResponse>(
+      info = ResponseInfo(
+        HttpStatusCode.BadRequest,
+        "Bad Things Happened"
+      )
+    ) {
      call.respond(HttpStatusCode.BadRequest, ExceptionResponse("Why you do dis?"))
    }
  }
@ -255,3 +274,88 @@ fun Application.nonRequiredParamsGet() {
    }
  }
 }
+
+fun Application.polymorphicResponse() {
+  routing {
+    route("/test/polymorphic") {
+      notarizedGet(TestResponseInfo.polymorphicResponse) {
+        call.respond(HttpStatusCode.OK, SimpleGibbit("hey"))
+      }
+    }
+  }
+}
+
+fun Application.polymorphicCollectionResponse() {
+  routing {
+    route("/test/polymorphiclist") {
+      notarizedGet(TestResponseInfo.polymorphicListResponse) {
+        call.respond(HttpStatusCode.OK, listOf(SimpleGibbit("hi")))
+      }
+    }
+  }
+}
+
+fun Application.polymorphicMapResponse() {
+  routing {
+    route("/test/polymorphicmap") {
+      notarizedGet(TestResponseInfo.polymorphicMapResponse) {
+        call.respond(HttpStatusCode.OK, listOf(SimpleGibbit("hi")))
+      }
+    }
+  }
+}
+
+fun Application.polymorphicInterfaceResponse() {
+  routing {
+    route("/test/polymorphicmap") {
+      notarizedGet(TestResponseInfo.polymorphicInterfaceResponse) {
+        call.respond(HttpStatusCode.OK, listOf(SimpleGibbit("hi")))
+      }
+    }
+  }
+}
+
+fun Application.genericPolymorphicResponse() {
+  routing {
+    route("/test/polymorphic") {
+      notarizedGet(TestResponseInfo.genericPolymorphicResponse) {
+        call.respond(HttpStatusCode.OK, Gibbity("hey"))
+      }
+    }
+  }
+}
+
+fun Application.genericPolymorphicResponseMultipleImpls() {
+  routing {
+    route("/test/polymorphic") {
+      notarizedGet(TestResponseInfo.genericPolymorphicResponse) {
+        call.respond(HttpStatusCode.OK, Gibbity("hey"))
+      }
+    }
+    route("/test/also/poly") {
+      notarizedGet(TestResponseInfo.anotherGenericPolymorphicResponse) {
+        call.respond(HttpStatusCode.OK, Bibbity("test", ComplexGibbit("nice", 1)))
+      }
+    }
+  }
+}
+
+fun Application.undeclaredType() {
+  routing {
+    route("/test/polymorphic") {
+      notarizedGet(TestResponseInfo.undeclaredResponseType) {
+        call.respond(HttpStatusCode.OK, Mysterious("hi"))
+      }
+    }
+  }
+}
+
+fun Application.simpleGenericResponse() {
+  routing {
+    route("/test/polymorphic") {
+      notarizedGet(TestResponseInfo.genericResponse) {
+        call.respond(HttpStatusCode.OK, Gibbity("hey"))
+      }
+    }
+  }
+}
--- a/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestResponseInfo.kt
+++ b/kompendium-core/src/test/kotlin/io/bkbn/kompendium/util/TestResponseInfo.kt
@ -1,9 +1,12 @@
 package io.bkbn.kompendium.util

-import io.ktor.http.HttpStatusCode
-import io.bkbn.kompendium.models.meta.MethodInfo
+import io.bkbn.kompendium.models.meta.MethodInfo.DeleteInfo
+import io.bkbn.kompendium.models.meta.MethodInfo.GetInfo
+import io.bkbn.kompendium.models.meta.MethodInfo.PostInfo
+import io.bkbn.kompendium.models.meta.MethodInfo.PutInfo
 import io.bkbn.kompendium.models.meta.RequestInfo
 import io.bkbn.kompendium.models.meta.ResponseInfo
+import io.ktor.http.HttpStatusCode

 object TestResponseInfo {
  private val testGetResponse = ResponseInfo<TestResponse>(HttpStatusCode.OK, "A Successful Endeavor")
@ -16,12 +19,12 @@ object TestResponseInfo {
  private val testRequest = RequestInfo<TestRequest>("A Test request")
  private val testRequestAgain = RequestInfo<Int>("A Test request")
  private val complexRequest = RequestInfo<ComplexRequest>("A Complex request")
-  val testGetInfo = MethodInfo.GetInfo<TestParams, TestResponse>(
+  val testGetInfo = GetInfo<TestParams, TestResponse>(
    summary = "Another get test",
    description = "testing more",
    responseInfo = testGetResponse
  )
-  val testGetInfoAgain = MethodInfo.GetInfo<TestParams, List<TestResponse>>(
+  val testGetInfoAgain = GetInfo<TestParams, List<TestResponse>>(
    summary = "Another get test",
    description = "testing more",
    responseInfo = testGetListResponse
@ -32,40 +35,84 @@ object TestResponseInfo {
  val testGetWithMultipleExceptions = testGetInfo.copy(
    canThrow = setOf(AccessDeniedException::class, Exception::class)
  )
-  val testPostInfo = MethodInfo.PostInfo<TestParams, TestRequest, TestCreatedResponse>(
+  val testPostInfo = PostInfo<TestParams, TestRequest, TestCreatedResponse>(
    summary = "Test post endpoint",
    description = "Post your tests here!",
    responseInfo = testPostResponse,
    requestInfo = testRequest
  )
-  val testPutInfo = MethodInfo.PutInfo<Unit, ComplexRequest, TestCreatedResponse>(
+  val testPutInfo = PutInfo<Unit, ComplexRequest, TestCreatedResponse>(
    summary = "Test put endpoint",
    description = "Put your tests here!",
    responseInfo = testPostResponse,
    requestInfo = complexRequest
  )
-  val testPutInfoAlso = MethodInfo.PutInfo<TestParams, TestRequest, TestCreatedResponse>(
+  val testPutInfoAlso = PutInfo<TestParams, TestRequest, TestCreatedResponse>(
    summary = "Test put endpoint",
    description = "Put your tests here!",
    responseInfo = testPostResponse,
    requestInfo = testRequest
  )
-  val testPutInfoAgain = MethodInfo.PutInfo<Unit, Int, Boolean>(
+  val testPutInfoAgain = PutInfo<Unit, Int, Boolean>(
    summary = "Test put endpoint",
    description = "Put your tests here!",
    responseInfo = testPostResponseAgain,
    requestInfo = testRequestAgain
  )
-  val testDeleteInfo = MethodInfo.DeleteInfo<TestParams, Unit>(
+  val testDeleteInfo = DeleteInfo<TestParams, Unit>(
    summary = "Test delete endpoint",
    description = "testing my deletes",
    responseInfo = testDeleteResponse
  )
  val emptyTestGetInfo =
-    MethodInfo.GetInfo<OptionalParams, Unit>(
+    GetInfo<OptionalParams, Unit>(
      summary = "No request params and response body",
      description = "testing more"
    )
-  val trulyEmptyTestGetInfo =
-    MethodInfo.GetInfo<Unit, Unit>(summary = "No request params and response body", description = "testing more")
+  val trulyEmptyTestGetInfo = GetInfo<Unit, Unit>(
+    summary = "No request params and response body",
+    description = "testing more"
+  )
+  val polymorphicResponse = GetInfo<Unit, FlibbityGibbit>(
+    summary = "All the gibbits",
+    description = "Polymorphic response",
+    responseInfo = simpleOkResponse()
+  )
+  val polymorphicListResponse = GetInfo<Unit, List<FlibbityGibbit>>(
+    summary = "Oh so many gibbits",
+    description = "Polymorphic list response",
+    responseInfo = simpleOkResponse()
+  )
+  val polymorphicMapResponse = GetInfo<Unit, Map<String, FlibbityGibbit>>(
+    summary = "By gawd that's a lot of gibbits",
+    description = "Polymorphic list response",
+    responseInfo = simpleOkResponse()
+  )
+  val polymorphicInterfaceResponse = GetInfo<Unit, SlammaJamma>(
+    summary = "Come on and slam",
+    description = "and welcome to the jam",
+    responseInfo = simpleOkResponse()
+  )
+  val genericPolymorphicResponse = GetInfo<Unit, Flibbity<TestNested>>(
+    summary = "More flibbity",
+    description = "Polymorphic with generics",
+    responseInfo = simpleOkResponse()
+  )
+  val anotherGenericPolymorphicResponse = GetInfo<Unit, Flibbity<FlibbityGibbit>>(
+    summary = "The Most Flibbity",
+    description = "Polymorphic with generics but like... crazier",
+    responseInfo = simpleOkResponse()
+  )
+  val undeclaredResponseType = GetInfo<Unit, Mysterious>(
+    summary = "spooky class",
+    description = "break this glass in scenario of emergency",
+    responseInfo = simpleOkResponse()
+  )
+  val genericResponse = GetInfo<Unit, TestGeneric<Int>>(
+    summary = "Single Generic",
+    description = "Simple generic data class",
+    responseInfo = simpleOkResponse()
+  )
+
+  private fun <T> simpleOkResponse() = ResponseInfo<T>(HttpStatusCode.OK, "A successful endeavor")
 }
--- a/kompendium-core/src/test/resources/complex_type.json
+++ b/kompendium-core/src/test/resources/complex_type.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -61,40 +61,26 @@
      "String" : {
        "type" : "string"
      },
-      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
-      },
-      "TestCreatedResponse" : {
-        "properties" : {
-          "c" : {
-            "$ref" : "#/components/schemas/String"
-          },
-          "id" : {
-            "$ref" : "#/components/schemas/Int"
-          }
-        },
-        "type" : "object"
-      },
      "SimpleEnum" : {
-        "enum" : [ "ONE", "TWO" ],
-        "type" : "string"
+        "type" : "string",
+        "enum" : [ "ONE", "TWO" ]
      },
      "CrazyItem" : {
+        "type" : "object",
        "properties" : {
          "enumeration" : {
            "$ref" : "#/components/schemas/SimpleEnum"
          }
-        },
-        "type" : "object"
+        }
      },
      "Map-String-CrazyItem" : {
+        "type" : "object",
        "additionalProperties" : {
          "$ref" : "#/components/schemas/CrazyItem"
-        },
-        "type" : "object"
+        }
      },
      "NestedComplexItem" : {
+        "type" : "object",
        "properties" : {
          "alias" : {
            "$ref" : "#/components/schemas/Map-String-CrazyItem"
@ -102,16 +88,16 @@
          "name" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "List-NestedComplexItem" : {
+        "type" : "array",
        "items" : {
          "$ref" : "#/components/schemas/NestedComplexItem"
-        },
-        "type" : "array"
+        }
      },
      "ComplexRequest" : {
+        "type" : "object",
        "properties" : {
          "amazingField" : {
            "$ref" : "#/components/schemas/String"
@ -122,8 +108,22 @@
          "tables" : {
            "$ref" : "#/components/schemas/List-NestedComplexItem"
          }
+        }
      },
-        "type" : "object"
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "TestCreatedResponse" : {
+        "type" : "object",
+        "properties" : {
+          "c" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "id" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/crazy_polymorphic_example.json
+++ b/kompendium-core/src/test/resources/crazy_polymorphic_example.json
@ -0,0 +1,164 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphic" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "More flibbity",
+        "description" : "Polymorphic with generics",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "anyOf" : [ {
+                    "$ref" : "#/components/schemas/Gibbity-TestNested"
+                  }, {
+                    "$ref" : "#/components/schemas/Bibbity-TestNested"
+                  } ]
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    },
+    "/test/also/poly" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "The Most Flibbity",
+        "description" : "Polymorphic with generics but like... crazier",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "anyOf" : [ {
+                    "$ref" : "#/components/schemas/Gibbity-FlibbityGibbit"
+                  }, {
+                    "$ref" : "#/components/schemas/Bibbity-FlibbityGibbit"
+                  } ]
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "nesty" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Gibbity-TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/TestNested"
+          }
+        }
+      },
+      "Bibbity-TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "f" : {
+            "$ref" : "#/components/schemas/TestNested"
+          }
+        }
+      },
+      "SimpleGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "ComplexGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "c" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      },
+      "Gibbity-FlibbityGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "anyOf" : [ {
+              "$ref" : "#/components/schemas/SimpleGibbit"
+            }, {
+              "$ref" : "#/components/schemas/ComplexGibbit"
+            } ]
+          }
+        }
+      },
+      "Bibbity-FlibbityGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "f" : {
+            "anyOf" : [ {
+              "$ref" : "#/components/schemas/SimpleGibbit"
+            }, {
+              "$ref" : "#/components/schemas/ComplexGibbit"
+            } ]
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/example_req_and_resp.json
+++ b/kompendium-core/src/test/resources/example_req_and_resp.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -85,40 +85,33 @@
  },
  "components" : {
    "schemas" : {
+      "Long" : {
+        "type" : "integer",
+        "format" : "int64"
+      },
+      "List-Long" : {
+        "type" : "array",
+        "items" : {
+          "$ref" : "#/components/schemas/Long"
+        }
+      },
+      "Double" : {
+        "type" : "number",
+        "format" : "double"
+      },
      "String" : {
        "type" : "string"
      },
-      "TestResponse" : {
-        "properties" : {
-          "c" : {
-            "$ref" : "#/components/schemas/String"
-          }
-        },
-        "type" : "object"
-      },
-      "Long" : {
-        "format" : "int64",
-        "type" : "integer"
-      },
-      "List-Long" : {
-        "items" : {
-          "$ref" : "#/components/schemas/Long"
-        },
-        "type" : "array"
-      },
-      "Double" : {
-        "format" : "double",
-        "type" : "number"
-      },
      "TestNested" : {
+        "type" : "object",
        "properties" : {
          "nesty" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "TestRequest" : {
+        "type" : "object",
        "properties" : {
          "aaa" : {
            "$ref" : "#/components/schemas/List-Long"
@ -129,8 +122,15 @@
          "fieldName" : {
            "$ref" : "#/components/schemas/TestNested"
          }
+        }
      },
-        "type" : "object"
+      "TestResponse" : {
+        "type" : "object",
+        "properties" : {
+          "c" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/generic_response.json
+++ b/kompendium-core/src/test/resources/generic_response.json
@ -0,0 +1,73 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphic" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "Single Generic",
+        "description" : "Simple generic data class",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/TestGeneric-Int"
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "TestGeneric-Int" : {
+        "type" : "object",
+        "properties" : {
+          "messy" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "potato" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/nested_under_root.json
+++ b/kompendium-core/src/test/resources/nested_under_root.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,16 +68,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/no_request_params_and_no_response_body.json
+++ b/kompendium-core/src/test/resources/no_request_params_and_no_response_body.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
--- a/kompendium-core/src/test/resources/non_required_params.json
+++ b/kompendium-core/src/test/resources/non_required_params.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
--- a/kompendium-core/src/test/resources/notarized_delete.json
+++ b/kompendium-core/src/test/resources/notarized_delete.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -61,8 +61,8 @@
        "type" : "string"
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_get.json
+++ b/kompendium-core/src/test/resources/notarized_get.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,16 +68,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_get_with_exception_response.json
+++ b/kompendium-core/src/test/resources/notarized_get_with_exception_response.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -78,24 +78,24 @@
        "type" : "string"
      },
      "ExceptionResponse" : {
+        "type" : "object",
        "properties" : {
          "message" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_get_with_multiple_exception_responses.json
+++ b/kompendium-core/src/test/resources/notarized_get_with_multiple_exception_responses.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -81,24 +81,24 @@
        "type" : "string"
      },
      "ExceptionResponse" : {
+        "type" : "object",
        "properties" : {
          "message" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_post.json
+++ b/kompendium-core/src/test/resources/notarized_post.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -75,47 +75,33 @@
  },
  "components" : {
    "schemas" : {
+      "Long" : {
+        "type" : "integer",
+        "format" : "int64"
+      },
+      "List-Long" : {
+        "type" : "array",
+        "items" : {
+          "$ref" : "#/components/schemas/Long"
+        }
+      },
+      "Double" : {
+        "type" : "number",
+        "format" : "double"
+      },
      "String" : {
        "type" : "string"
      },
-      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
-      },
-      "TestCreatedResponse" : {
-        "properties" : {
-          "c" : {
-            "$ref" : "#/components/schemas/String"
-          },
-          "id" : {
-            "$ref" : "#/components/schemas/Int"
-          }
-        },
-        "type" : "object"
-      },
-      "Long" : {
-        "format" : "int64",
-        "type" : "integer"
-      },
-      "List-Long" : {
-        "items" : {
-          "$ref" : "#/components/schemas/Long"
-        },
-        "type" : "array"
-      },
-      "Double" : {
-        "format" : "double",
-        "type" : "number"
-      },
      "TestNested" : {
+        "type" : "object",
        "properties" : {
          "nesty" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "TestRequest" : {
+        "type" : "object",
        "properties" : {
          "aaa" : {
            "$ref" : "#/components/schemas/List-Long"
@ -126,8 +112,22 @@
          "fieldName" : {
            "$ref" : "#/components/schemas/TestNested"
          }
+        }
      },
-        "type" : "object"
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "TestCreatedResponse" : {
+        "type" : "object",
+        "properties" : {
+          "c" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "id" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_primitives.json
+++ b/kompendium-core/src/test/resources/notarized_primitives.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -58,12 +58,12 @@
  },
  "components" : {
    "schemas" : {
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
      "Boolean" : {
        "type" : "boolean"
-      },
-      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/notarized_put.json
+++ b/kompendium-core/src/test/resources/notarized_put.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -75,47 +75,33 @@
  },
  "components" : {
    "schemas" : {
+      "Long" : {
+        "type" : "integer",
+        "format" : "int64"
+      },
+      "List-Long" : {
+        "type" : "array",
+        "items" : {
+          "$ref" : "#/components/schemas/Long"
+        }
+      },
+      "Double" : {
+        "type" : "number",
+        "format" : "double"
+      },
      "String" : {
        "type" : "string"
      },
-      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
-      },
-      "TestCreatedResponse" : {
-        "properties" : {
-          "c" : {
-            "$ref" : "#/components/schemas/String"
-          },
-          "id" : {
-            "$ref" : "#/components/schemas/Int"
-          }
-        },
-        "type" : "object"
-      },
-      "Long" : {
-        "format" : "int64",
-        "type" : "integer"
-      },
-      "List-Long" : {
-        "items" : {
-          "$ref" : "#/components/schemas/Long"
-        },
-        "type" : "array"
-      },
-      "Double" : {
-        "format" : "double",
-        "type" : "number"
-      },
      "TestNested" : {
+        "type" : "object",
        "properties" : {
          "nesty" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "TestRequest" : {
+        "type" : "object",
        "properties" : {
          "aaa" : {
            "$ref" : "#/components/schemas/List-Long"
@ -126,8 +112,22 @@
          "fieldName" : {
            "$ref" : "#/components/schemas/TestNested"
          }
+        }
      },
-        "type" : "object"
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "TestCreatedResponse" : {
+        "type" : "object",
+        "properties" : {
+          "c" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "id" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/path_parser.json
+++ b/kompendium-core/src/test/resources/path_parser.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,16 +68,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/polymorphic_list_response.json
+++ b/kompendium-core/src/test/resources/polymorphic_list_response.json
@ -0,0 +1,91 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphiclist" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "Oh so many gibbits",
+        "description" : "Polymorphic list response",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/List-FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "SimpleGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "ComplexGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "c" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      },
+      "List-FlibbityGibbit" : {
+        "type" : "array",
+        "items" : {
+          "anyOf" : [ {
+            "$ref" : "#/components/schemas/SimpleGibbit"
+          }, {
+            "$ref" : "#/components/schemas/ComplexGibbit"
+          } ]
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/polymorphic_map_response.json
+++ b/kompendium-core/src/test/resources/polymorphic_map_response.json
@ -0,0 +1,91 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphicmap" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "By gawd that's a lot of gibbits",
+        "description" : "Polymorphic list response",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Map-String-FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "SimpleGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "ComplexGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "c" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      },
+      "Map-String-FlibbityGibbit" : {
+        "type" : "object",
+        "additionalProperties" : {
+          "anyOf" : [ {
+            "$ref" : "#/components/schemas/SimpleGibbit"
+          }, {
+            "$ref" : "#/components/schemas/ComplexGibbit"
+          } ]
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/polymorphic_response.json
+++ b/kompendium-core/src/test/resources/polymorphic_response.json
@ -0,0 +1,85 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphic" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "All the gibbits",
+        "description" : "Polymorphic response",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "anyOf" : [ {
+                    "$ref" : "#/components/schemas/SimpleGibbit"
+                  }, {
+                    "$ref" : "#/components/schemas/ComplexGibbit"
+                  } ]
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "SimpleGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "ComplexGibbit" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "c" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/polymorphic_response_with_generics.json
+++ b/kompendium-core/src/test/resources/polymorphic_response_with_generics.json
@ -0,0 +1,89 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphic" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "More flibbity",
+        "description" : "Polymorphic with generics",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "anyOf" : [ {
+                    "$ref" : "#/components/schemas/Gibbity-TestNested"
+                  }, {
+                    "$ref" : "#/components/schemas/Bibbity-TestNested"
+                  } ]
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "nesty" : {
+            "$ref" : "#/components/schemas/String"
+          }
+        }
+      },
+      "Gibbity-TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/TestNested"
+          }
+        }
+      },
+      "Bibbity-TestNested" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "f" : {
+            "$ref" : "#/components/schemas/TestNested"
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/query_with_default_parameter.json
+++ b/kompendium-core/src/test/resources/query_with_default_parameter.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -32,9 +32,9 @@
          "name" : "a",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
+            "default" : 100,
            "type" : "integer",
-            "default" : 100
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -65,16 +65,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      },
      "Boolean" : {
        "type" : "boolean"
--- a/kompendium-core/src/test/resources/response_list.json
+++ b/kompendium-core/src/test/resources/response_list.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,22 +68,22 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "List-TestResponse" : {
+        "type" : "array",
        "items" : {
          "$ref" : "#/components/schemas/TestResponse"
-        },
-        "type" : "array"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/root_route.json
+++ b/kompendium-core/src/test/resources/root_route.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,16 +68,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/sealed_interface_response.json
+++ b/kompendium-core/src/test/resources/sealed_interface_response.json
@ -0,0 +1,83 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphicmap" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "Come on and slam",
+        "description" : "and welcome to the jam",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "anyOf" : [ {
+                    "$ref" : "#/components/schemas/OneJamma"
+                  }, {
+                    "$ref" : "#/components/schemas/AnothaJamma"
+                  } ]
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "Int" : {
+        "type" : "integer",
+        "format" : "int32"
+      },
+      "OneJamma" : {
+        "type" : "object",
+        "properties" : {
+          "a" : {
+            "$ref" : "#/components/schemas/Int"
+          }
+        }
+      },
+      "Float" : {
+        "type" : "number",
+        "format" : "float"
+      },
+      "AnothaJamma" : {
+        "type" : "object",
+        "properties" : {
+          "b" : {
+            "$ref" : "#/components/schemas/Float"
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-core/src/test/resources/trailing_slash.json
+++ b/kompendium-core/src/test/resources/trailing_slash.json
@ -3,7 +3,7 @@
  "info" : {
    "title" : "Test API",
    "version" : "1.33.7",
-    "description" : "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
    "termsOfService" : "https://example.com",
    "contact" : {
      "name" : "Homer Simpson",
@ -40,8 +40,8 @@
          "name" : "aa",
          "in" : "query",
          "schema" : {
-            "format" : "int32",
-            "type" : "integer"
+            "type" : "integer",
+            "format" : "int32"
          },
          "required" : true,
          "deprecated" : false
@ -68,16 +68,16 @@
        "type" : "string"
      },
      "TestResponse" : {
+        "type" : "object",
        "properties" : {
          "c" : {
            "$ref" : "#/components/schemas/String"
          }
-        },
-        "type" : "object"
+        }
      },
      "Int" : {
-        "format" : "int32",
-        "type" : "integer"
+        "type" : "integer",
+        "format" : "int32"
      }
    },
    "securitySchemes" : { }
--- a/kompendium-core/src/test/resources/undeclared_field.json
+++ b/kompendium-core/src/test/resources/undeclared_field.json
@ -0,0 +1,73 @@
+{
+  "openapi" : "3.0.3",
+  "info" : {
+    "title" : "Test API",
+    "version" : "1.33.7",
+    "description" : "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService" : "https://example.com",
+    "contact" : {
+      "name" : "Homer Simpson",
+      "url" : "https://gph.is/1NPUDiM",
+      "email" : "chunkylover53@aol.com"
+    },
+    "license" : {
+      "name" : "MIT",
+      "url" : "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers" : [ {
+    "url" : "https://myawesomeapi.com",
+    "description" : "Production instance of my API"
+  }, {
+    "url" : "https://staging.myawesomeapi.com",
+    "description" : "Where the fun stuff happens"
+  } ],
+  "paths" : {
+    "/test/polymorphic" : {
+      "get" : {
+        "tags" : [ ],
+        "summary" : "spooky class",
+        "description" : "break this glass in scenario of emergency",
+        "parameters" : [ ],
+        "responses" : {
+          "200" : {
+            "description" : "A successful endeavor",
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Mysterious"
+                }
+              }
+            }
+          }
+        },
+        "deprecated" : false
+      }
+    }
+  },
+  "components" : {
+    "schemas" : {
+      "String" : {
+        "type" : "string"
+      },
+      "Hehe" : {
+        "type" : "string",
+        "enum" : [ "HAHA", "HOHO" ]
+      },
+      "Mysterious" : {
+        "type" : "object",
+        "properties" : {
+          "nowYouSeeMe" : {
+            "$ref" : "#/components/schemas/String"
+          },
+          "nowYouDont" : {
+            "$ref" : "#/components/schemas/Hehe"
+          }
+        }
+      }
+    },
+    "securitySchemes" : { }
+  },
+  "security" : [ ],
+  "tags" : [ ]
+}
--- a/kompendium-playground/build.gradle.kts
+++ b/kompendium-playground/build.gradle.kts
@ -1,4 +1,5 @@
 plugins {
+  kotlin("plugin.serialization") version "1.5.0"
  application
 }

@ -11,15 +12,20 @@ dependencies {
  implementation(projects.kompendiumSwaggerUi)

  implementation(libs.bundles.ktor)
+  implementation(libs.ktor.jackson)
+  implementation(libs.kotlinx.serialization.json)
+  implementation(libs.ktor.serialization)
  implementation(libs.bundles.ktorAuth)
  implementation(libs.bundles.logging)

+  implementation("joda-time:joda-time:2.10.10")
+
  testImplementation("org.jetbrains.kotlin:kotlin-test")
  testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
 }

 application {
  @Suppress("DEPRECATION")
-  mainClassName = "org.leafygreens.kompendium.playground.MainKt"
+  mainClassName = "io.bkbn.kompendium.playground.MainKt"
  applicationDefaultJvmArgs = listOf("-Dio.ktor.development=true") // TODO I don't think this is working 😢
 }
--- a/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/Main.kt
+++ b/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/Main.kt
@ -1,7 +1,28 @@
 package io.bkbn.kompendium.playground

-import com.fasterxml.jackson.annotation.JsonInclude
-import com.fasterxml.jackson.databind.SerializationFeature
+import io.bkbn.kompendium.Kompendium
+import io.bkbn.kompendium.Notarized.notarizedDelete
+import io.bkbn.kompendium.Notarized.notarizedException
+import io.bkbn.kompendium.Notarized.notarizedGet
+import io.bkbn.kompendium.Notarized.notarizedPost
+import io.bkbn.kompendium.Notarized.notarizedPut
+import io.bkbn.kompendium.auth.KompendiumAuth.notarizedBasic
+import io.bkbn.kompendium.models.meta.ResponseInfo
+import io.bkbn.kompendium.models.oas.FormatSchema
+import io.bkbn.kompendium.playground.PlaygroundToC.testAuthenticatedSingleGetInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testCustomOverride
+import io.bkbn.kompendium.playground.PlaygroundToC.testGetWithExamples
+import io.bkbn.kompendium.playground.PlaygroundToC.testIdGetInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testPostWithExamples
+import io.bkbn.kompendium.playground.PlaygroundToC.testSingleDeleteInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testSingleGetInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testSingleGetInfoWithThrowable
+import io.bkbn.kompendium.playground.PlaygroundToC.testSinglePostInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testSinglePutInfo
+import io.bkbn.kompendium.playground.PlaygroundToC.testUndeclaredFields
+import io.bkbn.kompendium.routes.openApi
+import io.bkbn.kompendium.routes.redoc
+import io.bkbn.kompendium.swagger.swaggerUI
 import io.ktor.application.Application
 import io.ktor.application.call
 import io.ktor.application.install
@ -11,35 +32,19 @@ import io.ktor.auth.authenticate
 import io.ktor.features.ContentNegotiation
 import io.ktor.features.StatusPages
 import io.ktor.http.HttpStatusCode
-import io.ktor.jackson.jackson
 import io.ktor.response.respond
 import io.ktor.response.respondText
 import io.ktor.routing.route
 import io.ktor.routing.routing
+import io.ktor.serialization.json
 import io.ktor.server.engine.embeddedServer
 import io.ktor.server.netty.Netty
 import io.ktor.webjars.Webjars
-import io.bkbn.kompendium.Notarized.notarizedDelete
-import io.bkbn.kompendium.Notarized.notarizedException
-import io.bkbn.kompendium.Notarized.notarizedGet
-import io.bkbn.kompendium.Notarized.notarizedPost
-import io.bkbn.kompendium.Notarized.notarizedPut
-import io.bkbn.kompendium.auth.KompendiumAuth.notarizedBasic
-import io.bkbn.kompendium.models.meta.ResponseInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testAuthenticatedSingleGetInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testGetWithExamples
-import io.bkbn.kompendium.playground.PlaygroundToC.testIdGetInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testPostWithExamples
-import io.bkbn.kompendium.playground.PlaygroundToC.testSingleDeleteInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testSingleGetInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testSingleGetInfoWithThrowable
-import io.bkbn.kompendium.playground.PlaygroundToC.testSinglePostInfo
-import io.bkbn.kompendium.playground.PlaygroundToC.testSinglePutInfo
-import io.bkbn.kompendium.routes.openApi
-import io.bkbn.kompendium.routes.redoc
-import org.leafygreens.kompendium.swagger.swaggerUI
+import org.joda.time.DateTime

 fun main() {
+  Kompendium.addCustomTypeSchema(DateTime::class, FormatSchema("date-time", "string"))
+
  embeddedServer(
    Netty,
    port = 8081,
@ -52,10 +57,7 @@ var featuresInstalled = false
 fun Application.configModule() {
  if (!featuresInstalled) {
    install(ContentNegotiation) {
-      jackson {
-        enable(SerializationFeature.INDENT_OUTPUT)
-        setSerializationInclusion(JsonInclude.Include.NON_NULL)
-      }
+      json()
    }
    install(Authentication) {
      notarizedBasic("basic") {
@ -119,6 +121,11 @@ fun Application.mainModule() {
          call.respondText { "heya" }
        }
      }
+      route("custom_override") {
+        notarizedGet(testCustomOverride) {
+          call.respondText { DateTime.now().toString() }
+        }
+      }
      authenticate("basic") {
        route("/authenticated/single") {
          notarizedGet(testAuthenticatedSingleGetInfo) {
@ -132,5 +139,10 @@ fun Application.mainModule() {
        error("bad things just happened")
      }
    }
+    route("/undeclared") {
+      notarizedGet(testUndeclaredFields) {
+        call.respondText { "hi" }
+      }
+    }
  }
 }
--- a/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/Models.kt
+++ b/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/Models.kt
@ -3,6 +3,8 @@ package io.bkbn.kompendium.playground
 import io.bkbn.kompendium.annotations.KompendiumField
 import io.bkbn.kompendium.annotations.KompendiumParam
 import io.bkbn.kompendium.annotations.ParamType
+import io.bkbn.kompendium.annotations.UndeclaredField
+import org.joda.time.DateTime

 data class ExampleParams(
  @KompendiumParam(ParamType.PATH) val id: Int,
@ -16,6 +18,8 @@ data class JustQuery(

 data class ExampleNested(val nesty: String)

+data class ExampleGeneric<T>(val potato: T)
+
 data class ExampleRequest(
  @KompendiumField(name = "field_name")
  val fieldName: ExampleNested,
@ -28,3 +32,13 @@ data class ExampleResponse(val c: String)
 data class ExceptionResponse(val message: String)

 data class ExampleCreatedResponse(val id: Int, val c: String)
+
+data class DateTimeWrapper(val dt: DateTime)
+
+enum class Testerino {
+  First,
+  Second
+}
+
+@UndeclaredField("type", Testerino::class)
+data class SimpleYetMysterious(val exists: Boolean)
--- a/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/PlaygroundToC.kt
+++ b/kompendium-playground/src/main/kotlin/io/bkbn/kompendium/playground/PlaygroundToC.kt
@ -37,7 +37,7 @@ object PlaygroundToC {
    canThrow = setOf(Exception::class)
  )

-  val testIdGetInfo = MethodInfo.GetInfo<ExampleParams, ExampleResponse>(
+  val testIdGetInfo = MethodInfo.GetInfo<ExampleParams, ExampleGeneric<Int>>(
    summary = "Get Test",
    description = "Test for the getting",
    tags = setOf("test", "sample", "get"),
@ -55,6 +55,15 @@ object PlaygroundToC {
      description = "Returns a different sample"
    )
  )
+  val testCustomOverride = MethodInfo.GetInfo<Unit, DateTimeWrapper>(
+    summary = "custom schema test",
+    description = "testing",
+    tags = setOf("custom"),
+    responseInfo = ResponseInfo(
+      status = HttpStatusCode.OK,
+      description = "good tings"
+    )
+  )
  val testSingleGetInfoWithThrowable = testSingleGetInfo.copy(
    summary = "Show me the error baby 🙏",
    canThrow = setOf(Exception::class)
@ -100,4 +109,13 @@ object PlaygroundToC {
    ),
    securitySchemes = setOf("basic")
  )
+  val testUndeclaredFields = MethodInfo.GetInfo<Unit, SimpleYetMysterious>(
+    summary = "Tests adding undeclared fields",
+    description = "vvv mysterious",
+    tags = setOf("mysterious"),
+    responseInfo = ResponseInfo(
+      status = HttpStatusCode.OK,
+      description = "good tings"
+    )
+  )
 }
--- a/kompendium-swagger-ui/build.gradle.kts
+++ b/kompendium-swagger-ui/build.gradle.kts
@ -1,6 +1,7 @@
 plugins {
  `java-library`
  `maven-publish`
+  signing
 }

 dependencies {
@ -11,12 +12,13 @@ dependencies {
  implementation(libs.webjars.swagger.ui)
  testImplementation("org.jetbrains.kotlin:kotlin-test")
  testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
-  testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.12.0")
-  testImplementation("io.ktor:ktor-server-test-host:1.5.3")
+  testImplementation(libs.jackson.module.kotlin)
+  testImplementation(libs.ktor.server.test.host)
 }

 java {
  withSourcesJar()
+  withJavadocJar()
 }

 publishing {
@ -34,6 +36,41 @@ publishing {
    create<MavenPublication>("kompendium") {
      from(components["kotlin"])
      artifact(tasks.sourcesJar)
+      artifact(tasks.javadocJar)
+      groupId = project.group.toString()
+      artifactId = project.name.toLowerCase()
+      version = project.version.toString()
+
+      pom {
+        name.set("Kompendium")
+        description.set("A minimally invasive OpenAPI spec generator for Ktor")
+        url.set("https://github.com/bkbnio/Kompendium")
+        licenses {
+          license {
+            name.set("MIT License")
+            url.set("https://mit-license.org/")
+          }
+        }
+        developers {
+          developer {
+            id.set("bkbnio")
+            name.set("Ryan Brink")
+            email.set("admin@bkbn.io")
+          }
+        }
+        scm {
+          connection.set("scm:git:git://github.com/bkbnio/Kompendium.git")
+          developerConnection.set("scm:git:ssh://github.com/bkbnio/Kompendium.git")
+          url.set("https://github.com/bkbnio/Kompendium.git")
+        }
+      }
    }
  }
 }
+
+signing {
+  val signingKey: String? by project
+  val signingPassword: String? by project
+  useInMemoryPgpKeys(signingKey, signingPassword)
+  sign(publishing.publications)
+}
--- a/kompendium-swagger-ui/src/main/kotlin/io/bkbn/kompendium/swagger/SwaggerUI.kt
+++ b/kompendium-swagger-ui/src/main/kotlin/io/bkbn/kompendium/swagger/SwaggerUI.kt
@ -1,4 +1,4 @@
-package org.leafygreens.kompendium.swagger
+package io.bkbn.kompendium.swagger

 import io.ktor.application.call
 import io.ktor.response.respondRedirect
Author	SHA1	Message	Date
Ryan Brink	6ba3617e32	add super hack to support undeclared polymorphic adapter fields (#84 )	2021-08-15 01:02:23 +00:00
Ryan Brink	c32c91829b	i forgot to bump the version :((((	2021-08-12 20:40:09 -05:00
Ryan Brink	b021935b10	allow custom type overrides (#83 )	2021-08-12 21:38:48 -04:00
Ryan Brink	3d99bf35fd	Support polymorphic collections and maps (#82 )	2021-08-12 22:32:18 +00:00
Victor	c5f8ace5d2	Added support for BigInteger and BigDecimal in responses (#76 )	2021-07-25 10:48:14 -04:00
Victor	b0149c293e	changed jvmTarget version from 11 to 1.8 (#74 )	2021-07-22 22:38:39 -04:00
Ryan Brink	925172cf86	encode oas to json internally (#69 )	2021-06-04 20:51:06 +00:00
Ryan Brink	aa3290243b	explicit decoupled serialization (#65 )	2021-06-03 09:00:33 -04:00
Ryan Brink	2e7dad444b	Update README.md	2021-05-30 16:02:25 -04:00
Ryan Brink	6e56bf7425	Update README.md	2021-05-30 16:01:40 -04:00
Ryan Brink	dfc1593022	Update README.md	2021-05-30 15:57:24 -04:00
Ryan Brink	5fe98a04e8	Maven Central Here We Come!! (#60 )	2021-05-23 13:47:48 -04:00
Ryan Brink	59c0c3aabf	Polymorphic and Generic Support (#59 )	2021-05-21 21:35:19 +00:00
Ryan Brink	c885ff1cfb	point well taken, this is a family show (#57 )	2021-05-10 13:23:56 +00:00
Ryan Brink	8c206b7ad6	Update README.md	2021-05-10 08:47:56 -04:00