Merge pull request #26 from samchon/features/checker

Add `IJsonSchema.IOneOf.discriminator`

src/OpenApi.ts

@@ -396,7 +396,7 @@ export namespace OpenApi {
    * Path item.
    *
    * `OpenApi.IPath` represents a path item of emended OpenAPI v3.1,
-   * collecting multiple method operations in a signgle path.
+   * collecting multiple method operations in a single path.
    */
   export interface IPath<
     Schema extends IJsonSchema = IJsonSchema,
@@ -787,7 +787,7 @@ export namespace OpenApi {
     }
 
     /**
-     * Array type.
+     * Array type info.
      */
     export interface IArray<Schema extends IJsonSchema = IJsonSchema>
       extends __ISignificant<"array"> {
@@ -986,6 +986,32 @@ export namespace OpenApi {
        * List of the union types.
        */
       oneOf: Exclude<Schema, IJsonSchema.IOneOf>[];
+
+      /**
+       * Discriminator info of the union type.
+       */
+      discriminator?: IOneOf.IDiscriminator;
+    }
+    export namespace IOneOf {
+      /**
+       * Discriminator info of the union type.
+       */
+      export interface IDiscriminator {
+        /**
+         * Property name for the discriminator.
+         */
+        propertyName: string;
+
+        /**
+         * Mapping of the discriminator value to the schema name.
+         *
+         * This property is valid only for {@link IReference} typed
+         * {@link IOneOf.oneof} elements. Therefore, `key` of `mapping` is
+         * the discriminator value, and `value` of `mapping` is the
+         * schema name like `#/components/schemas/SomeObject`.
+         */
+        mapping?: Record<string, string>;
+      }
     }
 
     /**

src/OpenApiV3.ts

@@ -251,6 +251,13 @@ export namespace OpenApiV3 {
     }
     export interface IOneOf extends __IAttribute {
       oneOf: IJsonSchema[];
+      discriminator?: IOneOf.IDiscriminator;
+    }
+    export namespace IOneOf {
+      export interface IDiscriminator {
+        propertyName: string;
+        mapping?: Record<string, string>;
+      }
     }
 
     export interface __ISignificant<Type extends string> extends __IAttribute {

src/OpenApiV3_1.ts

@@ -262,6 +262,13 @@ export namespace OpenApiV3_1 {
     }
     export interface IOneOf extends __IAttribute {
       oneOf: IJsonSchema[];
+      discriminator?: IOneOf.IDiscriminator;
+    }
+    export namespace IOneOf {
+      export interface IDiscriminator {
+        propertyName: string;
+        mapping?: Record<string, string>;
+      }
     }
 
     export interface IArray extends __ISignificant<"array"> {

src/internal/SwaggerV2Downgrader.ts

@@ -291,6 +291,7 @@ export namespace SwaggerV2Downgrader {
             ? { ...union[0] }
             : { "x-oneOf": union.map((u) => ({ ...u, nullable: undefined })) }),
         ...attribute,
+        ...(union.length > 1 ? { discriminator: undefined } : {}),
       };
     };