@nestia/migrate 6.0.6 → 7.0.0-dev.20250605

package/src/executable/migrate.ts

@@ -1,7 +1,7 @@
-#!/usr/bin/env node
-import { MigrateCommander } from "../internal/MigrateCommander";
-
-MigrateCommander.main().catch((exp) => {
-  console.error(exp);
-  process.exit(-1);
-});
+#!/usr/bin/env node
+import { NestiaMigrateCommander } from "./NestiaMigrateCommander";
+
+NestiaMigrateCommander.main().catch((exp) => {
+  console.error(exp);
+  process.exit(-1);
+});

package/src/factories/TypeLiteralFactory.ts

@@ -1,57 +1,57 @@
-import ts from "typescript";
-import { Escaper } from "typia/lib/utils/Escaper";
-
-export namespace TypeLiteralFactory {
-  export const generate = (value: any): ts.TypeNode =>
-    typeof value === "boolean"
-      ? generateBoolean(value)
-      : typeof value === "number"
-        ? generateNumber(value)
-        : typeof value === "string"
-          ? generatestring(value)
-          : typeof value === "object"
-            ? value === null
-              ? generateNull()
-              : Array.isArray(value)
-                ? generateTuple(value)
-                : generateObject(value)
-            : ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword);
-
-  const generatestring = (str: string) =>
-    ts.factory.createLiteralTypeNode(ts.factory.createStringLiteral(str));
-
-  const generateNumber = (num: number) =>
-    ts.factory.createLiteralTypeNode(
-      num < 0
-        ? ts.factory.createPrefixUnaryExpression(
-            ts.SyntaxKind.MinusToken,
-            ts.factory.createNumericLiteral(-num),
-          )
-        : ts.factory.createNumericLiteral(num),
-    );
-
-  const generateBoolean = (bool: boolean) =>
-    ts.factory.createLiteralTypeNode(
-      bool ? ts.factory.createTrue() : ts.factory.createFalse(),
-    );
-
-  const generateNull = () =>
-    ts.factory.createLiteralTypeNode(ts.factory.createNull());
-
-  const generateTuple = (items: any[]) =>
-    ts.factory.createTupleTypeNode(items.map(generate));
-
-  const generateObject = (obj: object) =>
-    ts.factory.createTypeLiteralNode(
-      Object.entries(obj).map(([key, value]) =>
-        ts.factory.createPropertySignature(
-          undefined,
-          Escaper.variable(key)
-            ? ts.factory.createIdentifier(key)
-            : ts.factory.createStringLiteral(key),
-          undefined,
-          generate(value),
-        ),
-      ),
-    );
-}
+import ts from "typescript";
+import { Escaper } from "typia/lib/utils/Escaper";
+
+export namespace TypeLiteralFactory {
+  export const generate = (value: any): ts.TypeNode =>
+    typeof value === "boolean"
+      ? generateBoolean(value)
+      : typeof value === "number"
+        ? generateNumber(value)
+        : typeof value === "string"
+          ? generatestring(value)
+          : typeof value === "object"
+            ? value === null
+              ? generateNull()
+              : Array.isArray(value)
+                ? generateTuple(value)
+                : generateObject(value)
+            : ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword);
+
+  const generatestring = (str: string) =>
+    ts.factory.createLiteralTypeNode(ts.factory.createStringLiteral(str));
+
+  const generateNumber = (num: number) =>
+    ts.factory.createLiteralTypeNode(
+      num < 0
+        ? ts.factory.createPrefixUnaryExpression(
+            ts.SyntaxKind.MinusToken,
+            ts.factory.createNumericLiteral(-num),
+          )
+        : ts.factory.createNumericLiteral(num),
+    );
+
+  const generateBoolean = (bool: boolean) =>
+    ts.factory.createLiteralTypeNode(
+      bool ? ts.factory.createTrue() : ts.factory.createFalse(),
+    );
+
+  const generateNull = () =>
+    ts.factory.createLiteralTypeNode(ts.factory.createNull());
+
+  const generateTuple = (items: any[]) =>
+    ts.factory.createTupleTypeNode(items.map(generate));
+
+  const generateObject = (obj: object) =>
+    ts.factory.createTypeLiteralNode(
+      Object.entries(obj).map(([key, value]) =>
+        ts.factory.createPropertySignature(
+          undefined,
+          Escaper.variable(key)
+            ? ts.factory.createIdentifier(key)
+            : ts.factory.createStringLiteral(key),
+          undefined,
+          generate(value),
+        ),
+      ),
+    );
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-import * as migrate from "./module";
-
-export default migrate;
-export * from "./module";
+import * as migrate from "./module";
+
+export default migrate;
+export * from "./module";

package/src/module.ts

@@ -1,8 +1,2 @@
-export * from "./MigrateApplication";
-
-export * from "./analyzers/MigrateApplicationAnalyzer";
-
-export * from "./archivers/MigrateFileArchiver";
-
-export * from "./structures/IHttpMigrateProgram";
-export * from "./structures/IHttpMigrateSchema";
+export * from "./NestiaMigrateApplication";
+export * from "./structures/INestiaMigrateContext";

package/src/programmers/NestiaMigrateApiFileProgrammer.ts

@@ -0,0 +1,55 @@
+import { IHttpMigrateRoute, OpenApi } from "@samchon/openapi";
+import ts from "typescript";
+
+import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
+import { FilePrinter } from "../utils/FilePrinter";
+import { NestiaMigrateApiFunctionProgrammer } from "./NestiaMigrateApiFunctionProgrammer";
+import { NestiaMigrateApiNamespaceProgrammer } from "./NestiaMigrateApiNamespaceProgrammer";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+
+export namespace NestiaMigrateApiFileProgrammer {
+  export interface IProps {
+    config: INestiaMigrateConfig;
+    components: OpenApi.IComponents;
+    namespace: string[];
+    routes: IHttpMigrateRoute[];
+    children: Set<string>;
+  }
+
+  export const write = (props: IProps): ts.Statement[] => {
+    const importer: NestiaMigrateImportProgrammer =
+      new NestiaMigrateImportProgrammer();
+    const statements: ts.Statement[] = props.routes
+      .map((route) => [
+        FilePrinter.newLine(),
+        NestiaMigrateApiFunctionProgrammer.write({
+          config: props.config,
+          components: props.components,
+          importer,
+          route,
+        }),
+        NestiaMigrateApiNamespaceProgrammer.write({
+          config: props.config,
+          components: props.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/NestiaMigrateApiFunctionProgrammer.ts

@@ -0,0 +1,256 @@
+import { IHttpMigrateRoute, OpenApi } from "@samchon/openapi";
+import ts from "typescript";
+import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
+
+import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
+import { FilePrinter } from "../utils/FilePrinter";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+import { NestiaMigrateSchemaProgrammer } from "./NestiaMigrateSchemaProgrammer";
+
+export namespace NestiaMigrateApiFunctionProgrammer {
+  export interface IContext {
+    config: INestiaMigrateConfig;
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    route: IHttpMigrateRoute;
+  }
+
+  export const write = (ctx: IContext): ts.FunctionDeclaration =>
+    FilePrinter.description(
+      ts.factory.createFunctionDeclaration(
+        [
+          ts.factory.createModifier(ts.SyntaxKind.ExportKeyword),
+          ts.factory.createModifier(ts.SyntaxKind.AsyncKeyword),
+        ],
+        undefined,
+        ctx.route.accessor.at(-1)!,
+        undefined,
+        writeParameterDeclarations(ctx),
+        ts.factory.createTypeReferenceNode("Promise", [
+          ts.factory.createTypeReferenceNode(
+            ctx.route.success === null
+              ? "void"
+              : `${ctx.route.accessor.at(-1)!}.Response`,
+          ),
+        ]),
+        ts.factory.createBlock(writeBody(ctx), true),
+      ),
+      writeDescription(ctx.config, ctx.route),
+    );
+
+  export const writeParameterDeclarations = (
+    ctx: IContext,
+  ): ts.ParameterDeclaration[] => {
+    const connection: ts.ParameterDeclaration = IdentifierFactory.parameter(
+      "connection",
+      ts.factory.createTypeReferenceNode(
+        ctx.importer.external({
+          type: "instance",
+          library: "@nestia/fetcher",
+          name: "IConnection",
+        }),
+        ctx.route.headers
+          ? [
+              ts.factory.createTypeReferenceNode(
+                `${ctx.route.accessor.at(-1)!}.Headers`,
+              ),
+            ]
+          : undefined,
+      ),
+    );
+    if (ctx.config.keyword === true) {
+      const isProps: boolean =
+        ctx.route.parameters.length > 0 ||
+        !!ctx.route.query ||
+        !!ctx.route.body;
+      if (isProps === false) return [connection];
+      return [
+        connection,
+        ts.factory.createParameterDeclaration(
+          undefined,
+          undefined,
+          "props",
+          undefined,
+          ts.factory.createTypeReferenceNode(
+            `${ctx.route.accessor.at(-1)!}.IProps`,
+          ),
+        ),
+      ];
+    }
+    return [
+      connection,
+      ...ctx.route.parameters.map((p) =>
+        IdentifierFactory.parameter(
+          p.key,
+          NestiaMigrateSchemaProgrammer.write({
+            components: ctx.components,
+            importer: ctx.importer,
+            schema: p.schema,
+          }),
+        ),
+      ),
+      ...(ctx.route.query
+        ? [
+            IdentifierFactory.parameter(
+              ctx.route.query.key,
+              ts.factory.createTypeReferenceNode(
+                `${ctx.route.accessor.at(-1)!}.Query`,
+              ),
+            ),
+          ]
+        : []),
+      ...(ctx.route.body
+        ? [
+            IdentifierFactory.parameter(
+              ctx.route.body.key,
+              ts.factory.createTypeReferenceNode(
+                `${ctx.route.accessor.at(-1)!}.RequestBody`,
+              ),
+              (ctx.route.body.type === "application/json" ||
+                ctx.route.body.type === "text/plain") &&
+                ctx.route.operation().requestBody?.required === false
+                ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+                : undefined,
+            ),
+          ]
+        : []),
+    ];
+  };
+
+  const writeDescription = (
+    config: INestiaMigrateConfig,
+    route: IHttpMigrateRoute,
+  ): string => {
+    const comment: string = route.comment();
+    return [
+      config.keyword === true
+        ? comment.split("@param ").join("@param props.")
+        : comment,
+      `@path ${route.emendedPath}`,
+      `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
+    ].join("\n");
+  };
+
+  const writeBody = (ctx: IContext): ts.Statement[] => {
+    const encrypted: boolean = !!ctx.route.success?.["x-nestia-encrypted"];
+    const contentType: string = ctx.route.body?.type ?? "application/json";
+
+    const property = (key: string): ts.Expression =>
+      ctx.config.keyword === true
+        ? IdentifierFactory.access(ts.factory.createIdentifier("props"), key)
+        : ts.factory.createIdentifier(key);
+    const fetch = () =>
+      ts.factory.createCallExpression(
+        IdentifierFactory.access(
+          ts.factory.createIdentifier(
+            ctx.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(ctx.route.accessor.at(-1)!),
+                  "METADATA",
+                ),
+              ),
+              ts.factory.createPropertyAssignment(
+                "path",
+                ts.factory.createCallExpression(
+                  IdentifierFactory.access(
+                    ts.factory.createIdentifier(ctx.route.accessor.at(-1)!),
+                    "path",
+                  ),
+                  undefined,
+                  getArguments(ctx, false),
+                ),
+              ),
+              ts.factory.createPropertyAssignment(
+                "status",
+                ts.factory.createNull(),
+              ),
+            ],
+            true,
+          ),
+          ...(ctx.route.body ? [property(ctx.route.body.key)] : []),
+        ],
+      );
+    if (ctx.config.simulate !== true)
+      return [ts.factory.createReturnStatement(fetch())];
+    return [
+      ts.factory.createReturnStatement(
+        ts.factory.createConditionalExpression(
+          ts.factory.createIdentifier("!!connection.simulate"),
+          undefined,
+          ts.factory.createCallExpression(
+            ts.factory.createIdentifier(
+              `${ctx.route.accessor.at(-1)!}.simulate`,
+            ),
+            [],
+            [
+              ts.factory.createIdentifier("connection"),
+              ...getArguments(ctx, true),
+            ],
+          ),
+          undefined,
+          fetch(),
+        ),
+      ),
+    ];
+  };
+
+  const getArguments = (ctx: IContext, body: boolean): ts.Expression[] => {
+    if (
+      ctx.route.parameters.length === 0 &&
+      ctx.route.query === null &&
+      (body === false || ctx.route.body === null)
+    )
+      return [];
+    else if (ctx.config.keyword === true)
+      return [ts.factory.createIdentifier("props")];
+    return [
+      ...ctx.route.parameters.map((p) => ts.factory.createIdentifier(p.key)),
+      ...(ctx.route.query
+        ? [ts.factory.createIdentifier(ctx.route.query.key)]
+        : []),
+      ...(body && ctx.route.body
+        ? [ts.factory.createIdentifier(ctx.route.body.key)]
+        : []),
+    ];
+  };
+}