@nestia/migrate 0.12.0 → 0.13.0-dev.20240411

package/src/MigrateApplication.ts

@@ -1,86 +1,81 @@
-import typia, { IValidation } from "typia";
-
-import { MigrateAnalyzer } from "./analyzers/MigrateAnalyzer";
-import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
-import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
-import { MigrateApiProgrammer } from "./programmers/MigrateApiProgrammer";
-import { MigrateApiStartProgrammer } from "./programmers/MigrateApiStartProgrammer";
-import { MigrateE2eProgrammer } from "./programmers/MigrateE2eProgrammer";
-import { MigrateNestProgrammer } from "./programmers/MigrateNestProgrammer";
-import { IMigrateFile } from "./structures/IMigrateFile";
-import { IMigrateProgram } from "./structures/IMigrateProgram";
-import { ISwagger } from "./structures/ISwagger";
-import { ISwaggerV31 } from "./structures/ISwaggerV31";
-import { OpenApiConverter } from "./utils/OpenApiConverter";
-
-export class MigrateApplication {
-  private constructor(public readonly swagger: ISwagger) {}
-
-  public static async create(
-    swagger: ISwagger | ISwaggerV31,
-  ): Promise<IValidation<MigrateApplication>> {
-    swagger = typia.is<ISwaggerV31.IVersion>(swagger)
-      ? OpenApiConverter.v3_1(swagger)
-      : swagger;
-    const result = typia.validate<ISwagger>(swagger);
-    if (result.success === false) return result;
-    return {
-      success: true,
-      data: new MigrateApplication(swagger),
-      errors: [],
-    };
-  }
-
-  public nest(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
-    const program: IMigrateProgram = MigrateAnalyzer.analyze({
-      mode: "nest",
-      swagger: this.swagger,
-      dictionary: new Map(),
-      simulate: config.simulate,
-      e2e: config.e2e,
-    });
-    return {
-      program,
-      files: [
-        ...NEST_TEMPLATE,
-        ...MigrateNestProgrammer.write(program),
-        ...MigrateApiProgrammer.write(program),
-        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
-      ],
-    };
-  }
-
-  public sdk(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
-    const program: IMigrateProgram = MigrateAnalyzer.analyze({
-      mode: "sdk",
-      swagger: this.swagger,
-      dictionary: new Map(),
-      simulate: config.simulate,
-      e2e: config.e2e,
-    });
-    return {
-      program,
-      files: [
-        ...SDK_TEMPLATE,
-        ...MigrateApiProgrammer.write(program),
-        MigrateApiStartProgrammer.write(program),
-        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
-        {
-          location: "",
-          file: "swagger.json",
-          content: JSON.stringify(this.swagger, null, 2),
-        },
-      ],
-    };
-  }
-}
-export namespace MigrateApplication {
-  export interface IOutput {
-    program: IMigrateProgram;
-    files: IMigrateFile[];
-  }
-  export interface IConfig {
-    simulate: boolean;
-    e2e: boolean;
-  }
-}
+import { OpenApi, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@samchon/openapi";
+import typia, { IValidation } from "typia";
+
+import { MigrateAnalyzer } from "./analyzers/MigrateAnalyzer";
+import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
+import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
+import { MigrateApiProgrammer } from "./programmers/MigrateApiProgrammer";
+import { MigrateApiStartProgrammer } from "./programmers/MigrateApiStartProgrammer";
+import { MigrateE2eProgrammer } from "./programmers/MigrateE2eProgrammer";
+import { MigrateNestProgrammer } from "./programmers/MigrateNestProgrammer";
+import { IMigrateFile } from "./structures/IMigrateFile";
+import { IMigrateProgram } from "./structures/IMigrateProgram";
+
+export class MigrateApplication {
+  private constructor(public readonly document: OpenApi.IDocument) {}
+
+  public static async create(
+    document: SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument,
+  ): Promise<IValidation<MigrateApplication>> {
+    const result = typia.validate(document);
+    if (result.success === false) return result;
+    return {
+      success: true,
+      data: new MigrateApplication(OpenApi.convert(document)),
+      errors: [],
+    };
+  }
+
+  public nest(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
+    const program: IMigrateProgram = MigrateAnalyzer.analyze({
+      mode: "nest",
+      document: this.document,
+      dictionary: new Map(),
+      simulate: config.simulate,
+      e2e: config.e2e,
+    });
+    return {
+      program,
+      files: [
+        ...NEST_TEMPLATE,
+        ...MigrateNestProgrammer.write(program),
+        ...MigrateApiProgrammer.write(program),
+        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
+      ],
+    };
+  }
+
+  public sdk(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
+    const program: IMigrateProgram = MigrateAnalyzer.analyze({
+      mode: "sdk",
+      document: this.document,
+      dictionary: new Map(),
+      simulate: config.simulate,
+      e2e: config.e2e,
+    });
+    return {
+      program,
+      files: [
+        ...SDK_TEMPLATE,
+        ...MigrateApiProgrammer.write(program),
+        MigrateApiStartProgrammer.write(program),
+        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
+        {
+          location: "",
+          file: "swagger.json",
+          content: JSON.stringify(this.document, null, 2),
+        },
+      ],
+    };
+  }
+}
+export namespace MigrateApplication {
+  export interface IOutput {
+    program: IMigrateProgram;
+    files: IMigrateFile[];
+  }
+  export interface IConfig {
+    simulate: boolean;
+    e2e: boolean;
+  }
+}

package/src/analyzers/MigrateControllerAnalyzer.ts

@@ -1,9 +1,9 @@
+import { OpenApi } from "@samchon/openapi";
 import { Escaper } from "typia/lib/utils/Escaper";
 
 import { IMigrateController } from "../structures/IMigrateController";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerRoute } from "../structures/ISwaggerRoute";
 import { MapUtil } from "../utils/MapUtil";
 import { StringUtil } from "../utils/StringUtil";
 import { MigrateMethodAnalzyer } from "./MigrateMethodAnalyzer";
@@ -13,13 +13,15 @@ export namespace MigrateControllerAnalyzer {
     props: IMigrateProgram.IProps,
   ): IMigrateController[] => {
     interface IEntry {
-      endpoint: ISwaggerRoute;
+      endpoint: OpenApi.IOperation;
       route: IMigrateRoute;
     }
     const endpoints: Map<string, IEntry[]> = new Map();
 
     // GATHER ROUTES
-    for (const [path, collection] of Object.entries(props.swagger.paths)) {
+    for (const [path, collection] of Object.entries(
+      props.document.paths ?? {},
+    )) {
       if (collection === undefined) continue;
 
       // PREPARE DIRECTORIES
@@ -39,10 +41,10 @@ export namespace MigrateControllerAnalyzer {
         const r: IMigrateRoute | null = MigrateMethodAnalzyer.analyze(props)({
           path,
           method,
-        })(value);
+        })(value as OpenApi.IOperation);
         if (r === null) continue;
         routes.push({
-          endpoint: value,
+          endpoint: value as OpenApi.IOperation,
           route: r,
         });
       }

package/src/analyzers/MigrateMethodAnalyzer.ts

@@ -1,71 +1,28 @@
-import typia from "typia";
+import { OpenApi } from "@samchon/openapi";
 import { Escaper } from "typia/lib/utils/Escaper";
 
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwagger } from "../structures/ISwagger";
-import { ISwaggerRoute } from "../structures/ISwaggerRoute";
-import { ISwaggerRouteBodyContent } from "../structures/ISwaggerRouteBodyContent";
-import { ISwaggerRouteParameter } from "../structures/ISwaggerRouteParameter";
-import { ISwaggerRouteResponse } from "../structures/ISwaggerRouteResponse";
-import { ISwaggerSchema } from "../structures/ISwaggerSchema";
+import { OpenApiTypeChecker } from "../utils/OpenApiTypeChecker";
 import { StringUtil } from "../utils/StringUtil";
-import { SwaggerComponentsExplorer } from "../utils/SwaggerComponentsExplorer";
-import { SwaggerTypeChecker } from "../utils/SwaggerTypeChecker";
 
 export namespace MigrateMethodAnalzyer {
   export const analyze =
     (props: Omit<IMigrateProgram.IProps, "dictionary">) =>
     (endpoint: { path: string; method: string }) =>
-    (route: ISwaggerRoute): IMigrateRoute | null => {
+    (route: OpenApi.IOperation): IMigrateRoute | null => {
       const body = emplaceBodySchema("request")(
-        emplaceReference(props.swagger)("body"),
+        emplaceReference(props.document)("body"),
       )(route.requestBody);
       const success = emplaceBodySchema("response")(
-        emplaceReference(props.swagger)("response"),
+        emplaceReference(props.document)("response"),
       )(
-        (() => {
-          const response =
-            route.responses?.["201"] ??
-            route.responses?.["200"] ??
-            route.responses?.default;
-          if (response === undefined) return undefined;
-          return (
-            SwaggerComponentsExplorer.getResponse(props.swagger.components)(
-              response,
-            ) ?? undefined
-          );
-        })(),
+        route.responses?.["201"] ??
+          route.responses?.["200"] ??
+          route.responses?.default,
       );
 
       const failures: string[] = [];
-      for (const p of route.parameters ?? [])
-        if (
-          SwaggerComponentsExplorer.getParameter(props.swagger.components)(
-            p,
-          ) === null
-        )
-          failures.push(
-            `parameter "${(p as ISwaggerRouteParameter.IReference).$ref}" is not defined in "components.parameters".`,
-          );
-      for (const value of Object.values(route.responses ?? {}))
-        if (
-          SwaggerComponentsExplorer.getResponse(props.swagger.components)(
-            value,
-          ) === null
-        )
-          failures.push(
-            `response "${(value as ISwaggerRouteResponse.IReference).$ref}" is not defined in "components.responses".`,
-          );
-      if (
-        route.requestBody &&
-        SwaggerComponentsExplorer.getRequestBody(props.swagger.components)(
-          route.requestBody,
-        ) === null
-      )
-        failures.push(
-          `requestBody "${(route.requestBody as ISwaggerRouteParameter.IReference).$ref}" is not defined in "components.requestBodies".`,
-        );
       if (body === false)
         failures.push(
           `supports only "application/json", "application/x-www-form-urlencoded", "multipart/form-data" and "text/plain" content type in the request body.`,
@@ -80,28 +37,18 @@ export namespace MigrateMethodAnalzyer {
         );
 
       const [headers, query] = ["header", "query"].map((type) => {
-        const parameters: ISwaggerRouteParameter[] = (route.parameters ?? [])
-          .filter(
-            (p) =>
-              SwaggerComponentsExplorer.getParameter(props.swagger.components)(
-                p,
-              )?.in === type,
-          )
-          .map(
-            (p) =>
-              SwaggerComponentsExplorer.getParameter(props.swagger.components)(
-                p,
-              )!,
-          );
+        const parameters: OpenApi.IOperation.IParameter[] = (
+          route.parameters ?? []
+        ).filter((p) => p.in === type);
         if (parameters.length === 0) return null;
 
         const objects = parameters
           .map((p) =>
-            SwaggerTypeChecker.isObject(p.schema)
+            OpenApiTypeChecker.isObject(p.schema)
               ? p.schema
-              : SwaggerTypeChecker.isReference(p.schema) &&
-                  SwaggerTypeChecker.isObject(
-                    (props.swagger.components.schemas ?? {})[
+              : OpenApiTypeChecker.isReference(p.schema) &&
+                  OpenApiTypeChecker.isObject(
+                    props.document.components.schemas[
                       p.schema.$ref.replace(`#/components/schemas/`, ``)
                     ] ?? {},
                   )
@@ -111,11 +58,11 @@ export namespace MigrateMethodAnalzyer {
           .filter((s) => !!s);
         const primitives = parameters.filter(
           (p) =>
-            SwaggerTypeChecker.isBoolean(p.schema) ||
-            SwaggerTypeChecker.isNumber(p.schema) ||
-            SwaggerTypeChecker.isInteger(p.schema) ||
-            SwaggerTypeChecker.isString(p.schema) ||
-            SwaggerTypeChecker.isArray(p.schema),
+            OpenApiTypeChecker.isBoolean(p.schema) ||
+            OpenApiTypeChecker.isInteger(p.schema) ||
+            OpenApiTypeChecker.isNumber(p.schema) ||
+            OpenApiTypeChecker.isString(p.schema) ||
+            OpenApiTypeChecker.isArray(p.schema),
         );
         if (objects.length === 1 && primitives.length === 0) return objects[0];
         else if (objects.length > 1) {
@@ -125,23 +72,23 @@ export namespace MigrateMethodAnalzyer {
           return false;
         }
 
-        const dto: ISwaggerSchema.IObject | null = objects[0]
-          ? SwaggerTypeChecker.isObject(objects[0])
+        const dto: OpenApi.IJsonSchema.IObject | null = objects[0]
+          ? OpenApiTypeChecker.isObject(objects[0])
             ? objects[0]
-            : ((props.swagger.components.schemas ?? {})[
-                (objects[0] as ISwaggerSchema.IReference).$ref.replace(
+            : ((props.document.components.schemas ?? {})[
+                (objects[0] as OpenApi.IJsonSchema.IReference).$ref.replace(
                   `#/components/schemas/`,
                   ``,
                 )
-              ] as ISwaggerSchema.IObject)
+              ] as OpenApi.IJsonSchema.IObject)
           : null;
-        const entire: ISwaggerSchema.IObject[] = [
+        const entire: OpenApi.IJsonSchema.IObject[] = [
           ...objects.map((o) =>
-            SwaggerTypeChecker.isObject(o)
+            OpenApiTypeChecker.isObject(o)
               ? o
-              : (props.swagger.components.schemas?.[
+              : (props.document.components.schemas?.[
                   o.$ref.replace(`#/components/schemas/`, ``)
-                ]! as ISwaggerSchema.IObject),
+                ]! as OpenApi.IJsonSchema.IObject),
           ),
           {
             type: "object",
@@ -163,14 +110,14 @@ export namespace MigrateMethodAnalzyer {
         ];
         return parameters.length === 0
           ? null
-          : emplaceReference(props.swagger)(
+          : emplaceReference(props.document)(
               StringUtil.pascal(`I/Api/${endpoint.path}`) +
                 "." +
                 StringUtil.pascal(`${endpoint.method}/${type}`),
             )({
               type: "object",
               properties: Object.fromEntries([
-                ...new Map<string, ISwaggerSchema>(
+                ...new Map<string, OpenApi.IJsonSchema>(
                   entire
                     .map((o) =>
                       Object.entries(o.properties ?? {}).map(
@@ -181,7 +128,7 @@ export namespace MigrateMethodAnalzyer {
                               ...schema,
                               description:
                                 schema.description ?? schema.description,
-                            } as ISwaggerSchema,
+                            } as OpenApi.IJsonSchema,
                           ] as const,
                       ),
                     )
@@ -203,11 +150,7 @@ export namespace MigrateMethodAnalzyer {
         );
       if (
         parameterNames.length !==
-        (route.parameters ?? []).filter(
-          (p) =>
-            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p)
-              ?.in === "path",
-        ).length
+        route.parameters.filter((p) => p.in === "path").length
       )
         failures.push(
           "number of path parameters are not matched with its full path.",
@@ -233,11 +176,8 @@ export namespace MigrateMethodAnalzyer {
               schema: headers,
             }
           : null,
-        parameters: (route.parameters ?? [])
-          .map((p) =>
-            SwaggerComponentsExplorer.getParameter(props.swagger.components)(p),
-          )
-          .filter((p) => p !== null && p.in === "path")
+        parameters: route.parameters
+          .filter((p) => p.in === "path")
           .map((p, i) => ({
             name: parameterNames[i],
             key: (() => {
@@ -265,105 +205,77 @@ export namespace MigrateMethodAnalzyer {
         exceptions: Object.fromEntries(
           Object.entries(route.responses ?? {})
             .filter(
-              ([key, value]) =>
-                key !== "200" &&
-                key !== "201" &&
-                key !== "default" &&
-                !!SwaggerComponentsExplorer.getResponse(
-                  props.swagger.components,
-                )(value)?.content?.["application/json"],
+              ([key]) => key !== "200" && key !== "201" && key !== "default",
             )
-            .map(([key, value]) => {
-              const r = SwaggerComponentsExplorer.getResponse(
-                props.swagger.components,
-              )(value)!;
-              return [
-                key,
-                {
-                  description: r.description,
-                  schema: r.content?.["application/json"]?.schema ?? {},
-                },
-              ];
-            }),
+            .map(([key, value]) => [
+              key,
+              {
+                description: value.description,
+                schema: value.content?.["application/json"]?.schema ?? {},
+              },
+            ]),
         ),
         deprecated: route.deprecated ?? false,
-        comment: () => describe(props.swagger)(route),
+        comment: () => describe(route),
         tags: route.tags ?? [],
       };
     };
 
-  const describe =
-    (swagger: ISwagger) =>
-    (route: ISwaggerRoute): string => {
-      const commentTags: string[] = [];
-      const add = (text: string) => {
-        if (commentTags.every((line) => line !== text)) commentTags.push(text);
-      };
-
-      let description: string = route.description ?? "";
-      if (route.summary) {
-        const emended: string = route.summary.endsWith(".")
-          ? route.summary
-          : route.summary + ".";
-        if (
-          !!description.length &&
-          !description.startsWith(route.summary) &&
-          !route["x-nestia-jsDocTags"]?.some((t) => t.name === "summary")
-        )
-          description = `${emended}\n${description}`;
-      }
-      for (const p of route.parameters ?? []) {
-        const param: ISwaggerRouteParameter | null = (() => {
-          if (!typia.is<ISwaggerRouteParameter.IReference>(p))
-            return typia.is<ISwaggerRouteParameter>(p) ? p : null;
-          return (
-            swagger.components.parameters?.[
-              p.$ref.replace(`#/components/parameters/`, ``)
-            ] ?? null
-          );
-        })();
-        if (param !== null && param.description)
-          add(`@param ${param.name} ${param.description}`);
-      }
-      if (route.requestBody?.description)
-        add(`@param body ${route.requestBody.description}`);
-      for (const security of route.security ?? [])
-        for (const [name, scopes] of Object.entries(security))
-          add(`@security ${[name, ...scopes].join("")}`);
-      if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
-      if (route.deprecated) add("@deprecated");
-      return description.length
-        ? commentTags.length
-          ? `${description}\n\n${commentTags.join("\n")}`
-          : description
-        : commentTags.join("\n");
+  const describe = (route: OpenApi.IOperation): string => {
+    const commentTags: string[] = [];
+    const add = (text: string) => {
+      if (commentTags.every((line) => line !== text)) commentTags.push(text);
     };
 
-  const isNotObjectLiteral = (schema: ISwaggerSchema): boolean =>
-    SwaggerTypeChecker.isReference(schema) ||
-    SwaggerTypeChecker.isBoolean(schema) ||
-    SwaggerTypeChecker.isNumber(schema) ||
-    SwaggerTypeChecker.isString(schema) ||
-    SwaggerTypeChecker.isUnknown(schema) ||
-    (SwaggerTypeChecker.isAnyOf(schema) &&
-      schema.anyOf.every(isNotObjectLiteral)) ||
-    (SwaggerTypeChecker.isOneOf(schema) &&
+    let description: string = route.description ?? "";
+    if (route.summary) {
+      const emended: string = route.summary.endsWith(".")
+        ? route.summary
+        : route.summary + ".";
+      if (!!description.length && !description.startsWith(route.summary))
+        description = `${emended}\n${description}`;
+    }
+    for (const p of route.parameters)
+      if (p.description) add(`@param ${p.name} ${p.description}`);
+    if (route.requestBody?.description)
+      add(`@param body ${route.requestBody.description}`);
+    for (const security of route.security ?? [])
+      for (const [name, scopes] of Object.entries(security))
+        add(`@security ${[name, ...scopes].join("")}`);
+    if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
+    if (route.deprecated) add("@deprecated");
+    return description.length
+      ? commentTags.length
+        ? `${description}\n\n${commentTags.join("\n")}`
+        : description
+      : commentTags.join("\n");
+  };
+
+  const isNotObjectLiteral = (schema: OpenApi.IJsonSchema): boolean =>
+    OpenApiTypeChecker.isReference(schema) ||
+    OpenApiTypeChecker.isBoolean(schema) ||
+    OpenApiTypeChecker.isNumber(schema) ||
+    OpenApiTypeChecker.isString(schema) ||
+    OpenApiTypeChecker.isUnknown(schema) ||
+    (OpenApiTypeChecker.isOneOf(schema) &&
       schema.oneOf.every(isNotObjectLiteral)) ||
-    (SwaggerTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
+    (OpenApiTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
 
   const emplaceBodySchema =
     (from: "request" | "response") =>
-    (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
+    (
+      emplacer: (schema: OpenApi.IJsonSchema) => OpenApi.IJsonSchema.IReference,
+    ) =>
     (meta?: {
       description?: string;
-      content?: ISwaggerRouteBodyContent;
+      content?: Record<string, OpenApi.IOperation.IMediaType>; // ISwaggerRouteBodyContent;
       "x-nestia-encrypted"?: boolean;
     }): false | null | IMigrateRoute.IBody => {
       if (!meta?.content) return null;
 
-      const entries: [string, { schema: ISwaggerSchema }][] = Object.entries(
+      const entries: [string, OpenApi.IOperation.IMediaType][] = Object.entries(
         meta.content,
-      );
+      ).filter(([_, v]) => !!v);
       const json = entries.find((e) =>
         meta["x-nestia-encrypted"] === true
           ? e[0].includes("text/plain") || e[0].includes("application/json")
@@ -375,7 +287,11 @@ export namespace MigrateMethodAnalzyer {
           type: "application/json",
           name: "body",
           key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          schema: schema
+            ? isNotObjectLiteral(schema)
+              ? schema
+              : emplacer(schema)
+            : {},
           "x-nestia-encrypted": meta["x-nestia-encrypted"],
         };
       }
@@ -389,7 +305,11 @@ export namespace MigrateMethodAnalzyer {
           type: "application/x-www-form-urlencoded",
           name: "body",
           key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          schema: schema
+            ? isNotObjectLiteral(schema)
+              ? schema
+              : emplacer(schema)
+            : {},
         };
       }
 
@@ -412,7 +332,11 @@ export namespace MigrateMethodAnalzyer {
             type: "multipart/form-data",
             name: "body",
             key: "body",
-            schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+            schema: schema
+              ? isNotObjectLiteral(schema)
+                ? schema
+                : emplacer(schema)
+              : {},
           };
         }
       }
@@ -420,9 +344,9 @@ export namespace MigrateMethodAnalzyer {
     };
 
   const emplaceReference =
-    (swagger: ISwagger) =>
+    (swagger: OpenApi.IDocument) =>
     (name: string) =>
-    (schema: ISwaggerSchema): ISwaggerSchema.IReference => {
+    (schema: OpenApi.IJsonSchema): OpenApi.IJsonSchema.IReference => {
       swagger.components.schemas ??= {};
       swagger.components.schemas[name] = schema;
       return { $ref: `#/components/schemas/${name}` };