@nestia/migrate 0.7.6 → 0.7.8

package/src/analyzers/MigrateMethodAnalyzer.ts

@@ -1,348 +1,350 @@
-import { Escaper } from "typia/lib/utils/Escaper";
-
-import { ISwagger } from "../module";
-import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerSchema } from "../structures/ISwaggeSchema";
-import { ISwaggerRoute } from "../structures/ISwaggerRoute";
-import { StringUtil } from "../utils/StringUtil";
-import { SwaggerSwaggerChecker } from "../utils/SwaggerTypeChecker";
-
-export namespace MigrateMethodAnalzyer {
-  export const analyze =
-    (swagger: ISwagger) =>
-    (props: { path: string; method: string }) =>
-    (route: ISwaggerRoute): IMigrateRoute | null => {
-      const body = emplaceBodySchema("request")(
-        emplaceReference(swagger)("body"),
-      )(route.requestBody);
-      const success = emplaceBodySchema("response")(
-        emplaceReference(swagger)("response"),
-      )(route.responses?.["201"] ?? route.responses?.["200"]);
-
-      const failures: string[] = [];
-      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.`,
-        );
-      if (success === false)
-        failures.push(
-          `supports only "application/json", "application/x-www-form-urlencoded" and "text/plain" content type in the response body.`,
-        );
-      if (SUPPORTED_METHODS.has(props.method.toUpperCase()) === false)
-        failures.push(`does not support ${props.method.toUpperCase()} method.`);
-      if (failures.length) {
-        console.log(
-          `Failed to migrate ${props.method.toUpperCase()} ${props.path}`,
-          ...failures.map((f) => `  - ${f}`),
-        );
-        return null;
-      }
-
-      const [headers, query] = ["header", "query"].map((type) => {
-        const parameters = (route.parameters ?? []).filter(
-          (p) => p.in === type,
-        );
-        if (parameters.length === 0) return null;
-
-        const objects = parameters
-          .map((p) =>
-            SwaggerSwaggerChecker.isObject(p.schema)
-              ? p.schema
-              : SwaggerSwaggerChecker.isReference(p.schema) &&
-                  SwaggerSwaggerChecker.isObject(
-                    (swagger.components.schemas ?? {})[
-                      p.schema.$ref.replace(`#/components/schemas/`, ``)
-                    ] ?? {},
-                  )
-                ? p.schema
-                : null!,
-          )
-          .filter((s) => !!s);
-        const primitives = parameters.filter(
-          (p) =>
-            SwaggerSwaggerChecker.isBoolean(p.schema) ||
-            SwaggerSwaggerChecker.isNumber(p.schema) ||
-            SwaggerSwaggerChecker.isInteger(p.schema) ||
-            SwaggerSwaggerChecker.isString(p.schema) ||
-            SwaggerSwaggerChecker.isArray(p.schema),
-        );
-        if (objects.length === 1 && primitives.length === 0) return objects[0];
-        else if (objects.length > 1)
-          throw new Error(
-            `Error on nestia.migrate.RouteProgrammer.analze(): ${type} typed parameters must be only one object type - ${StringUtil.capitalize(
-              props.method,
-            )} "${props.path}".`,
-          );
-
-        const dto: ISwaggerSchema.IObject | null = objects[0]
-          ? SwaggerSwaggerChecker.isObject(objects[0])
-            ? objects[0]
-            : ((swagger.components.schemas ?? {})[
-                (objects[0] as ISwaggerSchema.IReference).$ref.replace(
-                  `#/components/schemas/`,
-                  ``,
-                )
-              ] as ISwaggerSchema.IObject)
-          : null;
-        const entire: ISwaggerSchema.IObject[] = [
-          ...objects.map((o) =>
-            SwaggerSwaggerChecker.isObject(o)
-              ? o
-              : (swagger.components.schemas?.[
-                  o.$ref.replace(`#/components/schemas/`, ``)
-                ]! as ISwaggerSchema.IObject),
-          ),
-          {
-            type: "object",
-            properties: Object.fromEntries([
-              ...primitives.map((p) => [
-                p.name,
-                {
-                  ...p.schema,
-                  description: p.schema.description ?? p.description,
-                },
-              ]),
-              ...(dto ? Object.entries(dto.properties ?? {}) : []),
-            ]),
-            required: [
-              ...primitives.filter((p) => p.required).map((p) => p.name!),
-              ...(dto ? dto.required ?? [] : []),
-            ],
-          },
-        ];
-        return parameters.length === 0
-          ? null
-          : emplaceReference(swagger)(
-              StringUtil.pascal(`I/Api/${props.path}`) +
-                "." +
-                StringUtil.pascal(`${props.method}/${type}`),
-            )({
-              type: "object",
-              properties: Object.fromEntries([
-                ...new Map<string, ISwaggerSchema>(
-                  entire
-                    .map((o) =>
-                      Object.entries(o.properties ?? {}).map(
-                        ([name, schema]) =>
-                          [
-                            name,
-                            {
-                              ...schema,
-                              description:
-                                schema.description ?? schema.description,
-                            } as ISwaggerSchema,
-                          ] as const,
-                      ),
-                    )
-                    .flat(),
-                ),
-              ]),
-              required: [
-                ...new Set(entire.map((o) => o.required ?? []).flat()),
-              ],
-            });
-      });
-
-      const parameterNames: string[] = StringUtil.splitWithNormalization(
-        props.path,
-      )
-        .filter((str) => str[0] === "{" || str[0] === ":")
-        .map((str) =>
-          str[0] === "{" ? str.substring(1, str.length - 1) : str.substring(1),
-        );
-      if (
-        parameterNames.length !==
-        (route.parameters ?? []).filter((p) => p.in === "path").length
-      ) {
-        console.log(
-          `Failed to migrate ${props.method.toUpperCase()} ${
-            props.path
-          }: number of path parameters are not matched with its full path.`,
-        );
-        return null;
-      }
-      return {
-        name: "@lazy",
-        path: props.path,
-        method: props.method,
-        accessor: ["@lazy"],
-        headers: headers
-          ? {
-              key: "headers",
-              schema: headers,
-            }
-          : null,
-        parameters: (route.parameters ?? [])
-          .filter((p) => p.in === "path")
-          .map((p, i) => ({
-            key: (() => {
-              let key: string = StringUtil.normalize(parameterNames[i]);
-              if (Escaper.variable(key)) return key;
-              while (true) {
-                key = "_" + key;
-                if (!parameterNames.some((s) => s === key)) return key;
-              }
-            })(),
-            schema: {
-              ...p.schema,
-              description: p.schema.description ?? p.description,
-            },
-          })),
-        query: query
-          ? {
-              key: "query",
-              schema: query,
-            }
-          : null,
-        body: body as IMigrateRoute.IBody,
-        success: success as IMigrateRoute.IBody,
-        exceptions: Object.fromEntries(
-          Object.entries(route.responses ?? {})
-            .filter(
-              ([key, value]) =>
-                key !== "200" &&
-                key !== "201" &&
-                !!value.content?.["application/json"],
-            )
-            .map(([key, value]) => [
-              key,
-              {
-                description: value.description,
-                schema: value.content?.["application/json"]?.schema ?? {},
-              },
-            ]),
-        ),
-        deprecated: route.deprecated ?? false,
-        description: describe(route),
-        tags: route.tags ?? [],
-      };
-    };
-
-  const describe = (route: ISwaggerRoute): string | undefined => {
-    const commentTags: string[] = [];
-    const add = (text: string) => {
-      if (commentTags.every((line) => line !== text)) commentTags.push(text);
-    };
-
-    let description: string | undefined = route.description;
-    if (route.summary) {
-      const emended: string = route.summary.endsWith(".")
-        ? route.summary
-        : route.summary + ".";
-      if (
-        description !== undefined &&
-        !description?.startsWith(route.summary) &&
-        !route["x-nestia-jsDocTags"]?.some((t) => t.name === "summary")
-      )
-        description = `${emended}\n${description}`;
-    }
-    if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
-    if (route.deprecated) add("@deprecated");
-    for (const security of route.security ?? [])
-      for (const [name, scopes] of Object.entries(security))
-        add(`@security ${[name, ...scopes].join("")}`);
-    for (const jsDocTag of route["x-nestia-jsDocTags"] ?? [])
-      if (jsDocTag.text?.length)
-        add(
-          `@${jsDocTag.name} ${jsDocTag.text
-            .map((text) => text.text)
-            .join("")}`,
-        );
-      else add(`@${jsDocTag.name}`);
-    return description?.length
-      ? commentTags.length
-        ? `${description}\n\n${commentTags.join("\n")}`
-        : description
-      : commentTags.join("\n");
-  };
-
-  const isNotObjectLiteral = (schema: ISwaggerSchema): boolean =>
-    SwaggerSwaggerChecker.isReference(schema) ||
-    SwaggerSwaggerChecker.isBoolean(schema) ||
-    SwaggerSwaggerChecker.isNumber(schema) ||
-    SwaggerSwaggerChecker.isString(schema) ||
-    SwaggerSwaggerChecker.isUnknown(schema) ||
-    (SwaggerSwaggerChecker.isAnyOf(schema) &&
-      schema.anyOf.every(isNotObjectLiteral)) ||
-    (SwaggerSwaggerChecker.isOneOf(schema) &&
-      schema.oneOf.every(isNotObjectLiteral)) ||
-    (SwaggerSwaggerChecker.isArray(schema) && isNotObjectLiteral(schema.items));
-
-  const emplaceBodySchema =
-    (from: "request" | "response") =>
-    (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
-    (meta?: {
-      description?: string;
-      content?: ISwaggerRoute.IContent;
-      "x-nestia-encrypted"?: boolean;
-    }): false | null | IMigrateRoute.IBody => {
-      if (!meta?.content) return null;
-
-      const entries: [string, { schema: ISwaggerSchema }][] = Object.entries(
-        meta.content,
-      );
-      const json = entries.find((e) =>
-        meta["x-nestia-encrypted"] === true
-          ? e[0].includes("text/plain") || e[0].includes("application/json")
-          : e[0].includes("application/json") || e[0].includes("*/*"),
-      );
-      if (json) {
-        const { schema } = json[1];
-        return {
-          type: "application/json",
-          key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
-          "x-nestia-encrypted": meta["x-nestia-encrypted"],
-        };
-      }
-
-      const query = entries.find((e) =>
-        e[0].includes("application/x-www-form-urlencoded"),
-      );
-      if (query) {
-        const { schema } = query[1];
-        return {
-          type: "application/x-www-form-urlencoded",
-          key: "body",
-          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
-        };
-      }
-
-      const text = entries.find((e) => e[0].includes("text/plain"));
-      if (text)
-        return { type: "text/plain", key: "body", schema: { type: "string" } };
-
-      if (from === "request") {
-        const multipart = entries.find((e) =>
-          e[0].includes("multipart/form-data"),
-        );
-        if (multipart) {
-          const { schema } = multipart[1];
-          return {
-            type: "multipart/form-data",
-            key: "body",
-            schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
-          };
-        }
-      }
-      return false;
-    };
-
-  const emplaceReference =
-    (swagger: ISwagger) =>
-    (name: string) =>
-    (schema: ISwaggerSchema): ISwaggerSchema.IReference => {
-      swagger.components.schemas ??= {};
-      swagger.components.schemas[name] = schema;
-      return { $ref: `#/components/schemas/${name}` };
-    };
-}
-
-const SUPPORTED_METHODS: Set<string> = new Set([
-  "GET",
-  "POST",
-  "PUT",
-  "PATCH",
-  "DELETE",
-  "HEAD",
-]);
+import { Escaper } from "typia/lib/utils/Escaper";
+
+import { IMigrateProgram, ISwagger } from "../module";
+import { IMigrateRoute } from "../structures/IMigrateRoute";
+import { ISwaggerSchema } from "../structures/ISwaggerSchema";
+import { ISwaggerRoute } from "../structures/ISwaggerRoute";
+import { StringUtil } from "../utils/StringUtil";
+import { SwaggerSwaggerChecker } from "../utils/SwaggerTypeChecker";
+
+export namespace MigrateMethodAnalzyer {
+  export const analyze =
+    (props: Omit<IMigrateProgram.IProps, "dictionary">) =>
+    (endpoint: { path: string; method: string }) =>
+    (route: ISwaggerRoute): IMigrateRoute | null => {
+      const body = emplaceBodySchema("request")(
+        emplaceReference(props.swagger)("body"),
+      )(route.requestBody);
+      const success = emplaceBodySchema("response")(
+        emplaceReference(props.swagger)("response"),
+      )(route.responses?.["201"] ?? route.responses?.["200"]);
+
+      const failures: string[] = [];
+      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.`,
+        );
+      if (success === false)
+        failures.push(
+          `supports only "application/json", "application/x-www-form-urlencoded" and "text/plain" content type in the response body.`,
+        );
+      if (SUPPORTED_METHODS.has(endpoint.method.toUpperCase()) === false)
+        failures.push(
+          `does not support ${endpoint.method.toUpperCase()} method.`,
+        );
+      if (failures.length) {
+        console.log(
+          `Failed to migrate ${endpoint.method.toUpperCase()} ${endpoint.path}`,
+          ...failures.map((f) => `  - ${f}`),
+        );
+        return null;
+      }
+
+      const [headers, query] = ["header", "query"].map((type) => {
+        const parameters = (route.parameters ?? []).filter(
+          (p) => p.in === type,
+        );
+        if (parameters.length === 0) return null;
+
+        const objects = parameters
+          .map((p) =>
+            SwaggerSwaggerChecker.isObject(p.schema)
+              ? p.schema
+              : SwaggerSwaggerChecker.isReference(p.schema) &&
+                  SwaggerSwaggerChecker.isObject(
+                    (props.swagger.components.schemas ?? {})[
+                      p.schema.$ref.replace(`#/components/schemas/`, ``)
+                    ] ?? {},
+                  )
+                ? p.schema
+                : null!,
+          )
+          .filter((s) => !!s);
+        const primitives = parameters.filter(
+          (p) =>
+            SwaggerSwaggerChecker.isBoolean(p.schema) ||
+            SwaggerSwaggerChecker.isNumber(p.schema) ||
+            SwaggerSwaggerChecker.isInteger(p.schema) ||
+            SwaggerSwaggerChecker.isString(p.schema) ||
+            SwaggerSwaggerChecker.isArray(p.schema),
+        );
+        if (objects.length === 1 && primitives.length === 0) return objects[0];
+        else if (objects.length > 1)
+          throw new Error(
+            `Error on nestia.migrate.RouteProgrammer.analze(): ${type} typed parameters must be only one object type - ${StringUtil.capitalize(
+              endpoint.method,
+            )} "${endpoint.path}".`,
+          );
+
+        const dto: ISwaggerSchema.IObject | null = objects[0]
+          ? SwaggerSwaggerChecker.isObject(objects[0])
+            ? objects[0]
+            : ((props.swagger.components.schemas ?? {})[
+                (objects[0] as ISwaggerSchema.IReference).$ref.replace(
+                  `#/components/schemas/`,
+                  ``,
+                )
+              ] as ISwaggerSchema.IObject)
+          : null;
+        const entire: ISwaggerSchema.IObject[] = [
+          ...objects.map((o) =>
+            SwaggerSwaggerChecker.isObject(o)
+              ? o
+              : (props.swagger.components.schemas?.[
+                  o.$ref.replace(`#/components/schemas/`, ``)
+                ]! as ISwaggerSchema.IObject),
+          ),
+          {
+            type: "object",
+            properties: Object.fromEntries([
+              ...primitives.map((p) => [
+                p.name,
+                {
+                  ...p.schema,
+                  description: p.schema.description ?? p.description,
+                },
+              ]),
+              ...(dto ? Object.entries(dto.properties ?? {}) : []),
+            ]),
+            required: [
+              ...primitives.filter((p) => p.required).map((p) => p.name!),
+              ...(dto ? dto.required ?? [] : []),
+            ],
+          },
+        ];
+        return parameters.length === 0
+          ? null
+          : emplaceReference(props.swagger)(
+              StringUtil.pascal(`I/Api/${endpoint.path}`) +
+                "." +
+                StringUtil.pascal(`${endpoint.method}/${type}`),
+            )({
+              type: "object",
+              properties: Object.fromEntries([
+                ...new Map<string, ISwaggerSchema>(
+                  entire
+                    .map((o) =>
+                      Object.entries(o.properties ?? {}).map(
+                        ([name, schema]) =>
+                          [
+                            name,
+                            {
+                              ...schema,
+                              description:
+                                schema.description ?? schema.description,
+                            } as ISwaggerSchema,
+                          ] as const,
+                      ),
+                    )
+                    .flat(),
+                ),
+              ]),
+              required: [
+                ...new Set(entire.map((o) => o.required ?? []).flat()),
+              ],
+            });
+      });
+
+      const parameterNames: string[] = StringUtil.splitWithNormalization(
+        endpoint.path,
+      )
+        .filter((str) => str[0] === "{" || str[0] === ":")
+        .map((str) =>
+          str[0] === "{" ? str.substring(1, str.length - 1) : str.substring(1),
+        );
+      if (
+        parameterNames.length !==
+        (route.parameters ?? []).filter((p) => p.in === "path").length
+      ) {
+        console.log(
+          `Failed to migrate ${endpoint.method.toUpperCase()} ${
+            endpoint.path
+          }: number of path parameters are not matched with its full path.`,
+        );
+        return null;
+      }
+      return {
+        name: "@lazy",
+        path: endpoint.path,
+        method: endpoint.method,
+        accessor: ["@lazy"],
+        headers: headers
+          ? {
+              key: "headers",
+              schema: headers,
+            }
+          : null,
+        parameters: (route.parameters ?? [])
+          .filter((p) => p.in === "path")
+          .map((p, i) => ({
+            key: (() => {
+              let key: string = StringUtil.normalize(parameterNames[i]);
+              if (Escaper.variable(key)) return key;
+              while (true) {
+                key = "_" + key;
+                if (!parameterNames.some((s) => s === key)) return key;
+              }
+            })(),
+            schema: {
+              ...p.schema,
+              description: p.schema.description ?? p.description,
+            },
+          })),
+        query: query
+          ? {
+              key: "query",
+              schema: query,
+            }
+          : null,
+        body: body as IMigrateRoute.IBody,
+        success: success as IMigrateRoute.IBody,
+        exceptions: Object.fromEntries(
+          Object.entries(route.responses ?? {})
+            .filter(
+              ([key, value]) =>
+                key !== "200" &&
+                key !== "201" &&
+                !!value.content?.["application/json"],
+            )
+            .map(([key, value]) => [
+              key,
+              {
+                description: value.description,
+                schema: value.content?.["application/json"]?.schema ?? {},
+              },
+            ]),
+        ),
+        deprecated: route.deprecated ?? false,
+        description: describe(route),
+        tags: route.tags ?? [],
+      };
+    };
+
+  const describe = (route: ISwaggerRoute): string | undefined => {
+    const commentTags: string[] = [];
+    const add = (text: string) => {
+      if (commentTags.every((line) => line !== text)) commentTags.push(text);
+    };
+
+    let description: string | undefined = route.description;
+    if (route.summary) {
+      const emended: string = route.summary.endsWith(".")
+        ? route.summary
+        : route.summary + ".";
+      if (
+        description !== undefined &&
+        !description?.startsWith(route.summary) &&
+        !route["x-nestia-jsDocTags"]?.some((t) => t.name === "summary")
+      )
+        description = `${emended}\n${description}`;
+    }
+    if (route.tags) route.tags.forEach((name) => add(`@tag ${name}`));
+    if (route.deprecated) add("@deprecated");
+    for (const security of route.security ?? [])
+      for (const [name, scopes] of Object.entries(security))
+        add(`@security ${[name, ...scopes].join("")}`);
+    for (const jsDocTag of route["x-nestia-jsDocTags"] ?? [])
+      if (jsDocTag.text?.length)
+        add(
+          `@${jsDocTag.name} ${jsDocTag.text
+            .map((text) => text.text)
+            .join("")}`,
+        );
+      else add(`@${jsDocTag.name}`);
+    return description?.length
+      ? commentTags.length
+        ? `${description}\n\n${commentTags.join("\n")}`
+        : description
+      : commentTags.join("\n");
+  };
+
+  const isNotObjectLiteral = (schema: ISwaggerSchema): boolean =>
+    SwaggerSwaggerChecker.isReference(schema) ||
+    SwaggerSwaggerChecker.isBoolean(schema) ||
+    SwaggerSwaggerChecker.isNumber(schema) ||
+    SwaggerSwaggerChecker.isString(schema) ||
+    SwaggerSwaggerChecker.isUnknown(schema) ||
+    (SwaggerSwaggerChecker.isAnyOf(schema) &&
+      schema.anyOf.every(isNotObjectLiteral)) ||
+    (SwaggerSwaggerChecker.isOneOf(schema) &&
+      schema.oneOf.every(isNotObjectLiteral)) ||
+    (SwaggerSwaggerChecker.isArray(schema) && isNotObjectLiteral(schema.items));
+
+  const emplaceBodySchema =
+    (from: "request" | "response") =>
+    (emplacer: (schema: ISwaggerSchema) => ISwaggerSchema.IReference) =>
+    (meta?: {
+      description?: string;
+      content?: ISwaggerRoute.IContent;
+      "x-nestia-encrypted"?: boolean;
+    }): false | null | IMigrateRoute.IBody => {
+      if (!meta?.content) return null;
+
+      const entries: [string, { schema: ISwaggerSchema }][] = Object.entries(
+        meta.content,
+      );
+      const json = entries.find((e) =>
+        meta["x-nestia-encrypted"] === true
+          ? e[0].includes("text/plain") || e[0].includes("application/json")
+          : e[0].includes("application/json") || e[0].includes("*/*"),
+      );
+      if (json) {
+        const { schema } = json[1];
+        return {
+          type: "application/json",
+          key: "body",
+          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          "x-nestia-encrypted": meta["x-nestia-encrypted"],
+        };
+      }
+
+      const query = entries.find((e) =>
+        e[0].includes("application/x-www-form-urlencoded"),
+      );
+      if (query) {
+        const { schema } = query[1];
+        return {
+          type: "application/x-www-form-urlencoded",
+          key: "body",
+          schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+        };
+      }
+
+      const text = entries.find((e) => e[0].includes("text/plain"));
+      if (text)
+        return { type: "text/plain", key: "body", schema: { type: "string" } };
+
+      if (from === "request") {
+        const multipart = entries.find((e) =>
+          e[0].includes("multipart/form-data"),
+        );
+        if (multipart) {
+          const { schema } = multipart[1];
+          return {
+            type: "multipart/form-data",
+            key: "body",
+            schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+          };
+        }
+      }
+      return false;
+    };
+
+  const emplaceReference =
+    (swagger: ISwagger) =>
+    (name: string) =>
+    (schema: ISwaggerSchema): ISwaggerSchema.IReference => {
+      swagger.components.schemas ??= {};
+      swagger.components.schemas[name] = schema;
+      return { $ref: `#/components/schemas/${name}` };
+    };
+}
+
+const SUPPORTED_METHODS: Set<string> = new Set([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "HEAD",
+]);