@nestia/migrate 6.0.6 → 7.0.0-dev.20250606

package/lib/structures/IHttpMigrateDto.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHttpMigrateDto.js","sourceRoot":"","sources":["../../src/structures/IHttpMigrateDto.ts"],"names":[],"mappings":""}

package/lib/structures/IHttpMigrateFile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHttpMigrateFile.js","sourceRoot":"","sources":["../../src/structures/IHttpMigrateFile.ts"],"names":[],"mappings":""}

package/lib/structures/IHttpMigrateProgram.d.ts

@@ -1,33 +0,0 @@
-import { OpenApi } from "@samchon/openapi";
-import { IHttpMigrateRoute } from "./IHttpMigrateRoute";
-export interface IHttpMigrateProgram extends IHttpMigrateProgram.IProps {
-    routes: IHttpMigrateRoute[];
-    errors: IHttpMigrateProgram.IError[];
-}
-export declare namespace IHttpMigrateProgram {
-    interface IProps {
-        mode: "nest" | "sdk";
-        simulate: boolean;
-        e2e: boolean;
-        document: OpenApi.IDocument;
-        author?: {
-            tag: string;
-            value: string;
-        };
-    }
-    interface IConfig {
-        mode: "nest" | "sdk";
-        simulate: boolean;
-        e2e: boolean;
-        author?: {
-            tag: string;
-            value: string;
-        };
-    }
-    interface IError {
-        method: string;
-        path: string;
-        operation: () => OpenApi.IOperation;
-        messages: string[];
-    }
-}

package/lib/structures/IHttpMigrateProgram.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHttpMigrateProgram.js","sourceRoot":"","sources":["../../src/structures/IHttpMigrateProgram.ts"],"names":[],"mappings":""}

package/lib/structures/IHttpMigrateRoute.d.ts

@@ -1 +0,0 @@
-export { IHttpMigrateRoute } from "@samchon/openapi";

package/lib/structures/IHttpMigrateRoute.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHttpMigrateRoute.js","sourceRoot":"","sources":["../../src/structures/IHttpMigrateRoute.ts"],"names":[],"mappings":""}

package/lib/structures/IHttpMigrateSchema.d.ts

@@ -1,4 +0,0 @@
-export interface IHttpMigrateSchema {
-    name: string;
-    children: IHttpMigrateSchema[];
-}

package/lib/structures/IHttpMigrateSchema.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IHttpMigrateSchema.js.map

package/lib/structures/IHttpMigrateSchema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHttpMigrateSchema.js","sourceRoot":"","sources":["../../src/structures/IHttpMigrateSchema.ts"],"names":[],"mappings":""}

package/src/MigrateApplication.ts

@@ -1,124 +0,0 @@
-import { OpenApi, OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@samchon/openapi";
-import typia, { IValidation } from "typia";
-
-import { MigrateApplicationAnalyzer } from "./analyzers/MigrateApplicationAnalyzer";
-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 { IHttpMigrateFile } from "./structures/IHttpMigrateFile";
-import { IHttpMigrateProgram } from "./structures/IHttpMigrateProgram";
-
-export class MigrateApplication {
-  private constructor(public readonly document: OpenApi.IDocument) {}
-
-  public static create(
-    document:
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApi.IDocument,
-  ): IValidation<MigrateApplication> {
-    const result: IValidation<
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApi.IDocument
-    > = typia.validate(document);
-    if (result.success === false) return result;
-    return {
-      success: true,
-      data: new MigrateApplication(OpenApi.convert(document)),
-    };
-  }
-
-  public nest(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
-    const program: IHttpMigrateProgram = MigrateApplicationAnalyzer.analyze({
-      mode: "nest",
-      document: this.document,
-      simulate: config.simulate,
-      e2e: config.e2e,
-      author: config.author,
-    });
-    const output: MigrateApplication.IOutput = {
-      program,
-      files: [
-        ...NEST_TEMPLATE.filter(
-          (f) =>
-            f.location.startsWith("src/api/structures") === false &&
-            f.location.startsWith("src/api/functional") === false &&
-            f.location.startsWith("src/api/controllers") === false &&
-            f.location.startsWith("test/features") === false,
-        ),
-        ...MigrateNestProgrammer.write(program),
-        ...MigrateApiProgrammer.write(program),
-        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
-      ],
-      errors: program.errors,
-    };
-    return this.finalize(config, output);
-  }
-
-  public sdk(config: MigrateApplication.IConfig): MigrateApplication.IOutput {
-    const program: IHttpMigrateProgram = MigrateApplicationAnalyzer.analyze({
-      mode: "sdk",
-      document: this.document,
-      simulate: config.simulate,
-      e2e: config.e2e,
-      author: config.author,
-    });
-    const output: MigrateApplication.IOutput = {
-      program,
-      files: [
-        ...SDK_TEMPLATE.filter(
-          (f) =>
-            f.location.startsWith("src/structures") === false &&
-            f.location.startsWith("src/functional") === false &&
-            f.location.startsWith("test/features") === false,
-        ),
-        ...MigrateApiProgrammer.write(program),
-        MigrateApiStartProgrammer.write(program),
-        ...(config.e2e ? MigrateE2eProgrammer.write(program) : []),
-        {
-          location: "",
-          file: "swagger.json",
-          content: JSON.stringify(this.document, null, 2),
-        },
-      ],
-      errors: program.errors,
-    };
-    return this.finalize(config, output);
-  }
-
-  private finalize(
-    config: MigrateApplication.IConfig,
-    output: MigrateApplication.IOutput,
-  ): MigrateApplication.IOutput {
-    if (config.package)
-      output.files = output.files.map((file) => ({
-        ...file,
-        content: file.content
-          .split(`@ORGANIZATION/PROJECT`)
-          .join(config.package),
-      }));
-    return output;
-  }
-}
-export namespace MigrateApplication {
-  export interface IOutput {
-    program: IHttpMigrateProgram;
-    files: IHttpMigrateFile[];
-    errors: IHttpMigrateProgram.IError[];
-  }
-  export interface IConfig {
-    simulate: boolean;
-    e2e: boolean;
-    package?: string;
-    author?: {
-      tag: string;
-      value: string;
-    };
-  }
-}

package/src/analyzers/MigrateApplicationAnalyzer.ts

@@ -1,18 +0,0 @@
-import { HttpMigration, IHttpMigrateApplication } from "@samchon/openapi";
-
-import { IHttpMigrateProgram } from "../structures/IHttpMigrateProgram";
-
-export namespace MigrateApplicationAnalyzer {
-  export const analyze = (
-    props: IHttpMigrateProgram.IProps,
-  ): IHttpMigrateProgram => {
-    const application: IHttpMigrateApplication = HttpMigration.application(
-      props.document,
-    );
-    return {
-      ...props,
-      routes: application.routes,
-      errors: application.errors,
-    };
-  };
-}

package/src/archivers/MigrateFileArchiver.ts

@@ -1,38 +0,0 @@
-import { IHttpMigrateFile } from "../structures/IHttpMigrateFile";
-
-export namespace MigrateFileArchiver {
-  export interface IOperator {
-    mkdir(path: string): Promise<void>;
-    writeFile(path: string, content: string): Promise<void>;
-  }
-
-  export const archive =
-    (operator: IOperator) =>
-    (output: string) =>
-    async (files: IHttpMigrateFile[]): Promise<void> => {
-      const visited: Set<string> = new Set();
-      for (const f of files) {
-        await mkdir(operator.mkdir)(output)(visited)(f.location);
-        await operator.writeFile(
-          [output, f.location, f.file].join("/"),
-          f.content,
-        );
-      }
-    };
-
-  const mkdir =
-    (creator: (path: string) => void) =>
-    (output: string) =>
-    (visited: Set<string>) =>
-    async (path: string): Promise<void> => {
-      const sequence: string[] = path
-        .split("/")
-        .map((_str, i, entire) => entire.slice(0, i + 1).join("/"));
-      for (const s of sequence)
-        if (visited.has(s) === false)
-          try {
-            await creator([output, s].join("/"));
-            visited.add(s);
-          } catch {}
-    };
-}

package/src/programmers/MigrateApiFileProgrammer.ts

@@ -1,51 +0,0 @@
-import { IHttpMigrateRoute, OpenApi } from "@samchon/openapi";
-import ts from "typescript";
-
-import { IHttpMigrateProgram } from "../structures/IHttpMigrateProgram";
-import { FilePrinter } from "../utils/FilePrinter";
-import { MigrateApiFunctionProgrammer } from "./MigrateApiFunctionProgrammer";
-import { MigrateApiNamespaceProgrammer } from "./MigrateApiNamespaceProgrammer";
-import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
-
-export namespace MigrateApiFileProgrammer {
-  export interface IProps {
-    namespace: string[];
-    routes: IHttpMigrateRoute[];
-    children: Set<string>;
-  }
-  export const write =
-    (config: IHttpMigrateProgram.IConfig) =>
-    (components: OpenApi.IComponents) =>
-    (props: IProps): ts.Statement[] => {
-      const importer: MigrateImportProgrammer = new MigrateImportProgrammer();
-      const statements: ts.Statement[] = props.routes
-        .map((route) => [
-          FilePrinter.newLine(),
-          MigrateApiFunctionProgrammer.write(config)(components)(importer)(
-            route,
-          ),
-          MigrateApiNamespaceProgrammer.write(config)(components)(importer)(
-            route,
-          ),
-        ])
-        .flat();
-      return [
-        ...importer.toStatements(
-          (ref) =>
-            `../${"../".repeat(props.namespace.length)}structures/${ref}`,
-        ),
-        ...[...props.children].map((child) =>
-          ts.factory.createExportDeclaration(
-            undefined,
-            false,
-            ts.factory.createNamespaceExport(
-              ts.factory.createIdentifier(child),
-            ),
-            ts.factory.createStringLiteral(`./${child}`),
-            undefined,
-          ),
-        ),
-        ...statements,
-      ];
-    };
-}

package/src/programmers/MigrateApiFunctionProgrammer.ts

@@ -1,213 +0,0 @@
-import { OpenApi } from "@samchon/openapi";
-import ts from "typescript";
-import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
-
-import { MigrateApplication } from "../MigrateApplication";
-import { IHttpMigrateProgram } from "../structures/IHttpMigrateProgram";
-import { IHttpMigrateRoute } from "../structures/IHttpMigrateRoute";
-import { FilePrinter } from "../utils/FilePrinter";
-import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
-import { MigrateSchemaProgrammer } from "./MigrateSchemaProgrammer";
-
-export namespace MigrateApiFunctionProgrammer {
-  export const write =
-    (config: IHttpMigrateProgram.IConfig) =>
-    (components: OpenApi.IComponents) =>
-    (importer: MigrateImportProgrammer) =>
-    (route: IHttpMigrateRoute): ts.FunctionDeclaration =>
-      FilePrinter.description(
-        ts.factory.createFunctionDeclaration(
-          [
-            ts.factory.createModifier(ts.SyntaxKind.ExportKeyword),
-            ts.factory.createModifier(ts.SyntaxKind.AsyncKeyword),
-          ],
-          undefined,
-          route.accessor.at(-1)!,
-          undefined,
-          writeParameterDeclarations(components)(importer)(route),
-          ts.factory.createTypeReferenceNode("Promise", [
-            ts.factory.createTypeReferenceNode(
-              route.success === null
-                ? "void"
-                : `${route.accessor.at(-1)!}.Output`,
-            ),
-          ]),
-          ts.factory.createBlock(writeBody(config)(importer)(route), true),
-        ),
-        writeDescription(config)(route),
-      );
-
-  export const writeParameterDeclarations =
-    (components: OpenApi.IComponents) =>
-    (importer: MigrateImportProgrammer) =>
-    (route: IHttpMigrateRoute): ts.ParameterDeclaration[] => [
-      IdentifierFactory.parameter(
-        "connection",
-        ts.factory.createTypeReferenceNode(
-          importer.external({
-            type: "instance",
-            library: "@nestia/fetcher",
-            name: "IConnection",
-          }),
-          route.headers
-            ? [
-                ts.factory.createTypeReferenceNode(
-                  `${route.accessor.at(-1)!}.Headers`,
-                ),
-              ]
-            : undefined,
-        ),
-      ),
-      ...route.parameters.map((p) =>
-        IdentifierFactory.parameter(
-          p.key,
-          MigrateSchemaProgrammer.write(components)(importer)(p.schema),
-        ),
-      ),
-      ...(route.query
-        ? [
-            IdentifierFactory.parameter(
-              route.query.key,
-              ts.factory.createTypeReferenceNode(
-                `${route.accessor.at(-1)!}.Query`,
-              ),
-            ),
-          ]
-        : []),
-      ...(route.body
-        ? [
-            IdentifierFactory.parameter(
-              route.body.key,
-              ts.factory.createTypeReferenceNode(
-                `${route.accessor.at(-1)!}.Input`,
-              ),
-              (route.body.type === "application/json" ||
-                route.body.type === "text/plain") &&
-                route.operation().requestBody?.required === false
-                ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
-                : undefined,
-            ),
-          ]
-        : []),
-    ];
-
-  const writeDescription =
-    (config: MigrateApplication.IConfig) =>
-    (route: IHttpMigrateRoute): string =>
-      [
-        route.comment(),
-        `@path ${route.emendedPath}`,
-        `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
-      ].join("\n");
-
-  const writeBody =
-    (config: IHttpMigrateProgram.IConfig) =>
-    (importer: MigrateImportProgrammer) =>
-    (route: IHttpMigrateRoute): ts.Statement[] => {
-      const encrypted: boolean = !!route.success?.["x-nestia-encrypted"];
-      const contentType: string = route.body?.type ?? "application/json";
-
-      const caller = () =>
-        ts.factory.createCallExpression(
-          IdentifierFactory.access(
-            ts.factory.createIdentifier(
-              importer.external({
-                type: "instance",
-                library: `@nestia/fetcher/lib/${encrypted ? "EncryptedFetcher" : "PlainFetcher"}`,
-                name: encrypted ? "EncryptedFetcher" : "PlainFetcher",
-              }),
-            ),
-            "fetch",
-          ),
-          undefined,
-          [
-            contentType && contentType !== "multipart/form-data"
-              ? ts.factory.createObjectLiteralExpression(
-                  [
-                    ts.factory.createSpreadAssignment(
-                      ts.factory.createIdentifier("connection"),
-                    ),
-                    ts.factory.createPropertyAssignment(
-                      "headers",
-                      ts.factory.createObjectLiteralExpression(
-                        [
-                          ts.factory.createSpreadAssignment(
-                            IdentifierFactory.access(
-                              ts.factory.createIdentifier("connection"),
-                              "headers",
-                            ),
-                          ),
-                          ts.factory.createPropertyAssignment(
-                            ts.factory.createStringLiteral("Content-Type"),
-                            ts.factory.createStringLiteral(contentType),
-                          ),
-                        ],
-                        true,
-                      ),
-                    ),
-                  ],
-                  true,
-                )
-              : ts.factory.createIdentifier("connection"),
-            ts.factory.createObjectLiteralExpression(
-              [
-                ts.factory.createSpreadAssignment(
-                  IdentifierFactory.access(
-                    ts.factory.createIdentifier(route.accessor.at(-1)!),
-                    "METADATA",
-                  ),
-                ),
-                ts.factory.createPropertyAssignment(
-                  "path",
-                  ts.factory.createCallExpression(
-                    IdentifierFactory.access(
-                      ts.factory.createIdentifier(route.accessor.at(-1)!),
-                      "path",
-                    ),
-                    undefined,
-                    [
-                      ...route.parameters.map((p) =>
-                        ts.factory.createIdentifier(p.key),
-                      ),
-                      ...(route.query
-                        ? [ts.factory.createIdentifier(route.query.key)]
-                        : []),
-                    ],
-                  ),
-                ),
-                ts.factory.createPropertyAssignment(
-                  "status",
-                  ts.factory.createNull(),
-                ),
-              ],
-              true,
-            ),
-            ...(route.body
-              ? [ts.factory.createIdentifier(route.body.key)]
-              : []),
-          ],
-        );
-      if (config.simulate !== true)
-        return [ts.factory.createReturnStatement(caller())];
-      return [
-        ts.factory.createReturnStatement(
-          ts.factory.createConditionalExpression(
-            ts.factory.createIdentifier("!!connection.simulate"),
-            undefined,
-            ts.factory.createCallExpression(
-              ts.factory.createIdentifier(`${route.accessor.at(-1)!}.simulate`),
-              [],
-              [
-                "connection",
-                ...route.parameters.map((p) => p.key),
-                ...(route.query ? [route.query.key] : []),
-                ...(route.body ? [route.body.key] : []),
-              ].map((key) => ts.factory.createIdentifier(key)),
-            ),
-            undefined,
-            caller(),
-          ),
-        ),
-      ];
-    };
-}