@nestia/sdk 10.0.2 → 11.0.0-dev.20260305

package/src/executable/internal/NestiaConfigLoader.ts

@@ -1,78 +1,85 @@
-import { NoTransformConfigurationError } from "@nestia/core/lib/decorators/NoTransformConfigurationError";
-import fs from "fs";
-import path from "path";
-import { register } from "ts-node";
-import { parse } from "tsconfck";
-import ts from "typescript";
-import typia from "typia";
-
-import { INestiaConfig } from "../../INestiaConfig";
-
-export namespace NestiaConfigLoader {
-  export const compilerOptions = async (
-    project: string,
-  ): Promise<ts.ParsedCommandLine> => {
-    const configFileName = ts.findConfigFile(
-      process.cwd(),
-      ts.sys.fileExists,
-      project,
-    );
-    if (!configFileName) throw new Error(`unable to find "${project}" file.`);
-    const { tsconfig } = await parse(configFileName);
-    const configFileText = JSON.stringify(tsconfig);
-    const { config } = ts.parseConfigFileTextToJson(
-      configFileName,
-      configFileText,
-    );
-    return ts.parseJsonConfigFileContent(
-      config,
-      ts.sys,
-      path.dirname(configFileName),
-    );
-  };
-
-  export const configurations = async (
-    file: string,
-    compilerOptions: Record<string, any>,
-  ): Promise<INestiaConfig[]> => {
-    if (fs.existsSync(path.resolve(file)) === false)
-      throw new Error(`Unable to find "${file}" file.`);
-
-    NoTransformConfigurationError.throws = false;
-    const plugins: any[] = [
-      ...typia
-        .assert<object[]>(compilerOptions.plugins ?? [])
-        .filter((x: any) => x.transform !== "@nestia/sdk/lib/transform"),
-      { transform: "@nestia/sdk/lib/transform" },
-    ];
-    register({
-      emit: false,
-      compilerOptions: {
-        ...compilerOptions,
-        plugins,
-      },
-      require: compilerOptions.baseUrl
-        ? ["tsconfig-paths/register"]
-        : undefined,
-    });
-
-    const loaded: (INestiaConfig | INestiaConfig[]) & {
-      default?: INestiaConfig | INestiaConfig[];
-    } = await import(path.resolve(file));
-    const instance: INestiaConfig | INestiaConfig[] =
-      typeof loaded?.default === "object" && loaded.default !== null
-        ? loaded.default
-        : loaded;
-    const configurations: INestiaConfig[] = Array.isArray(instance)
-      ? instance
-      : [instance];
-
-    try {
-      return typia.assert(configurations);
-    } catch (exp) {
-      if (typia.is<typia.TypeGuardError>(exp))
-        exp.message = `invalid "${file}" data.`;
-      throw exp;
-    }
-  };
-}
+import { NoTransformConfigurationError } from "@nestia/core";
+import fs from "fs";
+import path from "path";
+import { register } from "ts-node";
+import { parse } from "tsconfck";
+import ts from "typescript";
+import typia from "typia";
+
+import { INestiaConfig } from "../../INestiaConfig";
+
+export namespace NestiaConfigLoader {
+  export const compilerOptions = async (
+    project: string,
+  ): Promise<ts.ParsedCommandLine> => {
+    const configFileName = ts.findConfigFile(
+      process.cwd(),
+      ts.sys.fileExists,
+      project,
+    );
+    if (!configFileName) throw new Error(`unable to find "${project}" file.`);
+    const { tsconfig } = await parse(configFileName);
+    const configFileText = JSON.stringify(tsconfig);
+    const { config } = ts.parseConfigFileTextToJson(
+      configFileName,
+      configFileText,
+    );
+    return ts.parseJsonConfigFileContent(
+      config,
+      ts.sys,
+      path.dirname(configFileName),
+    );
+  };
+
+  export const configurations = async (
+    file: string,
+    compilerOptions: Record<string, any>,
+  ): Promise<INestiaConfig[]> => {
+    if (fs.existsSync(path.resolve(file)) === false)
+      throw new Error(`Unable to find "${file}" file.`);
+
+    NoTransformConfigurationError.throws = false;
+
+    const setup: boolean = typia
+      .assert<object[]>(compilerOptions.plugins ?? [])
+      .some(
+        (x: any) =>
+          x.transform === "@nestia/sdk/lib/transform" ||
+          x.transform === "@nestia/sdk/src/transform.ts",
+      );
+    const plugins: any[] = [
+      ...(compilerOptions.plugins ?? []),
+      ...(setup ? [{ transform: "@nestia/sdk/lib/transform" }] : []),
+    ];
+    if (!(process as any)[Symbol.for("ts-node.register.instance")])
+      register({
+        emit: false,
+        compilerOptions: {
+          ...compilerOptions,
+          plugins,
+        },
+        require: compilerOptions.baseUrl
+          ? ["tsconfig-paths/register"]
+          : undefined,
+      });
+
+    const loaded: (INestiaConfig | INestiaConfig[]) & {
+      default?: INestiaConfig | INestiaConfig[];
+    } = await import(path.resolve(file));
+    const instance: INestiaConfig | INestiaConfig[] =
+      typeof loaded?.default === "object" && loaded.default !== null
+        ? loaded.default
+        : loaded;
+    const configurations: INestiaConfig[] = Array.isArray(instance)
+      ? instance
+      : [instance];
+
+    try {
+      return typia.assert(configurations);
+    } catch (exp) {
+      if (typia.is<typia.TypeGuardError>(exp))
+        exp.message = `invalid "${file}" data.`;
+      throw exp;
+    }
+  };
+}

package/src/executable/internal/NestiaSdkCommand.ts

@@ -1,103 +1,107 @@
-import ts from "typescript";
-
-import { INestiaConfig } from "../../INestiaConfig";
-import { NestiaSdkApplication } from "../../NestiaSdkApplication";
-import { NestiaConfigLoader } from "./NestiaConfigLoader";
-
-export namespace NestiaSdkCommand {
-  export const sdk = () =>
-    main({
-      title: "SDK library",
-      generate: (app) => app.sdk(),
-      validate: (config) => !!config.output,
-      solution: "configure INestiaConfig.output property.",
-    });
-  export const swagger = () =>
-    main({
-      title: "Swagger Document",
-      generate: (app) => app.swagger(),
-      validate: (config) => !!config.swagger?.output,
-      solution: "configure INestiaConfig.swagger property.",
-    });
-  export const e2e = () =>
-    main({
-      title: "E2E Functions",
-      generate: (app) => app.e2e(),
-      validate: (config) => !!config.e2e,
-      solution: [
-        "configure two properties:",
-        "",
-        "  - INestiaConfig.output",
-        "  - INestiaConfig.e2e",
-      ].join("\n"),
-    });
-  export const all = () =>
-    main({
-      title: "everything",
-      generate: (app) => app.all(),
-      validate: () => true,
-      solution: [
-        "configure at least one property of below:",
-        "",
-        "  - INestiaConfig.output",
-        "  - INestiaConfig.swagger.output",
-      ].join("\n"),
-    });
-
-  const main = async (props: {
-    title: string;
-    solution: string;
-    generate: (app: NestiaSdkApplication) => Promise<void>;
-    validate: (config: INestiaConfig) => boolean;
-  }) => {
-    // LOAD CONFIG INFO
-    const command: ts.ParsedCommandLine =
-      await NestiaConfigLoader.compilerOptions(
-        getFileArgument({
-          type: "project",
-          extension: "json",
-        }) ?? "tsconfig.json",
-      );
-    const configurations: INestiaConfig[] =
-      await NestiaConfigLoader.configurations(
-        getFileArgument({
-          type: "config",
-          extension: "ts",
-        }) ?? "nestia.config.ts",
-        command.raw.compilerOptions,
-      );
-
-    // GENERATE
-    if (
-      configurations.length > 1 &&
-      configurations.some(props.validate) === false
-    )
-      throw new Error(
-        `Every configurations are invalid to generate ${props.title}, ${props.solution}`,
-      );
-    for (const config of configurations) {
-      if (configurations.length > 1 && props.validate(config) === false)
-        continue;
-      const app: NestiaSdkApplication = new NestiaSdkApplication(config);
-      await props.generate(app);
-    }
-  };
-
-  const getFileArgument = (props: {
-    type: string;
-    extension: string;
-  }): string | null => {
-    const argv: string[] = process.argv.slice(3);
-    if (argv.length === 0) return null;
-
-    const index: number = argv.findIndex((str) => str === `--${props.type}`);
-    if (index === -1) return null;
-    else if (argv.length === 1)
-      throw new Error(`${props.type} file must be provided`);
-
-    const file: string = argv[index + 1];
-    if (file.endsWith(props.extension) === false)
-      throw new Error(`${props.type} file must be ${props.extension} file`);
-    return file;
-  };
-}
+import ts from "typescript";
+
+import { INestiaConfig } from "../../INestiaConfig";
+import { NestiaSdkApplication } from "../../NestiaSdkApplication";
+import { NestiaConfigLoader } from "./NestiaConfigLoader";
+
+export namespace NestiaSdkCommand {
+  export const sdk = () =>
+    main({
+      title: "SDK library",
+      generate: (app) => app.sdk(),
+      validate: (config) => !!config.output,
+      solution: "configure INestiaConfig.output property.",
+    });
+
+  export const swagger = () =>
+    main({
+      title: "Swagger Document",
+      generate: (app) => app.swagger(),
+      validate: (config) => !!config.swagger?.output,
+      solution: "configure INestiaConfig.swagger property.",
+    });
+
+  export const e2e = () =>
+    main({
+      title: "E2E Functions",
+      generate: (app) => app.e2e(),
+      validate: (config) => !!config.e2e,
+      solution: [
+        "configure two properties:",
+        "",
+        "  - INestiaConfig.output",
+        "  - INestiaConfig.e2e",
+      ].join("\n"),
+    });
+
+  export const all = () =>
+    main({
+      title: "everything",
+      generate: (app) => app.all(),
+      validate: () => true,
+      solution: [
+        "configure at least one property of below:",
+        "",
+        "  - INestiaConfig.output",
+        "  - INestiaConfig.swagger.output",
+      ].join("\n"),
+    });
+
+  const main = async (props: {
+    title: string;
+    solution: string;
+    generate: (app: NestiaSdkApplication) => Promise<void>;
+    validate: (config: INestiaConfig) => boolean;
+  }) => {
+    // LOAD CONFIG INFO
+    const command: ts.ParsedCommandLine =
+      await NestiaConfigLoader.compilerOptions(
+        getFileArgument({
+          type: "project",
+          extension: "json",
+        }) ?? "tsconfig.json",
+      );
+
+    const configurations: INestiaConfig[] =
+      await NestiaConfigLoader.configurations(
+        getFileArgument({
+          type: "config",
+          extension: "ts",
+        }) ?? "nestia.config.ts",
+        command.raw.compilerOptions,
+      );
+
+    // GENERATE
+    if (
+      configurations.length > 1 &&
+      configurations.some(props.validate) === false
+    )
+      throw new Error(
+        `Every configurations are invalid to generate ${props.title}, ${props.solution}`,
+      );
+    for (const config of configurations) {
+      if (configurations.length > 1 && props.validate(config) === false)
+        continue;
+      const app: NestiaSdkApplication = new NestiaSdkApplication(config);
+      await props.generate(app);
+    }
+  };
+
+  const getFileArgument = (props: {
+    type: string;
+    extension: string;
+  }): string | null => {
+    const argv: string[] = process.argv.slice(3);
+    if (argv.length === 0) return null;
+
+    const index: number = argv.findIndex((str) => str === `--${props.type}`);
+    if (index === -1) return null;
+    else if (argv.length === 1)
+      throw new Error(`${props.type} file must be provided`);
+
+    const file: string = argv[index + 1]!;
+    if (file.endsWith(props.extension) === false)
+      throw new Error(`${props.type} file must be ${props.extension} file`);
+    return file;
+  };
+}

package/src/executable/sdk.ts

@@ -1,75 +1,75 @@
-#!/usr/bin/env node
-import cp from "child_process";
-import fs from "fs";
-import process from "process";
-
-import { CommandParser } from "./internal/CommandParser";
-import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
-
-const USAGE = `Wrong command has been detected. Use like below:
-
-npx @nestia/sdk [command] [options?]
-
-  1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
-    - npx @nestia/sdk dependencies
-    - npx @nestia/sdk dependencies --manager pnpm
-  2. npx @nestia/sdk init
-  3. npx @nestia/sdk sdk --config? [config file] --project? [project file]
-  4. npx @nestia/sdk swagger --config? [config file] --project? [project file]
-  5. npx @nestia/sdk e2e --config? [config file] --project? [project file]
-  6. npx @nestia/sdk generate --config? [config file] --project? [project file]
-`;
-
-function halt(desc: string): never {
-  console.error(desc);
-  process.exit(-1);
-}
-
-function dependencies(argv: string[]): void {
-  // INSTALL DEPENDENCIES
-  const module = CommandParser.parse(argv).module ?? "npm";
-  const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
-
-  for (const lib of ["@nestia/fetcher", "typia"]) {
-    const command: string = `${prefix} ${lib}`;
-    console.log(`\n$ ${command}`);
-    cp.execSync(command, { stdio: "inherit" });
-  }
-}
-
-async function initialize(): Promise<void> {
-  if (fs.existsSync("nestia.config.ts") === true)
-    halt(
-      `Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
-    );
-  await fs.promises.copyFile(
-    `${__dirname}/../../assets/config/nestia.config.ts`,
-    "nestia.config.ts",
-  );
-}
-
-async function execute(
-  closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
-): Promise<void> {
-  const module = await import("./internal/NestiaSdkCommand");
-  await closure(module.NestiaSdkCommand);
-}
-
-async function main() {
-  const type: string | undefined = process.argv[2];
-  const argv: string[] = process.argv.slice(3);
-
-  if (type === "dependencies") dependencies(argv);
-  else if (type === "init") await initialize();
-  else if (type === "sdk") await execute((c) => c.sdk());
-  else if (type === "swagger") await execute((c) => c.swagger());
-  else if (type === "e2e") await execute((c) => c.e2e());
-  else if (type === "all") await execute((c) => c.all());
-  else halt(USAGE);
-
-  process.exit(0);
-}
-main().catch((exp) => {
-  console.log(exp);
-  process.exit(-1);
-});
+#!/usr/bin/env node
+import cp from "child_process";
+import fs from "fs";
+import process from "process";
+
+import { CommandParser } from "./internal/CommandParser";
+import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
+
+const USAGE = `Wrong command has been detected. Use like below:
+
+npx @nestia/sdk [command] [options?]
+
+  1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
+    - npx @nestia/sdk dependencies
+    - npx @nestia/sdk dependencies --manager pnpm
+  2. npx @nestia/sdk init
+  3. npx @nestia/sdk sdk --config? [config file] --project? [project file]
+  4. npx @nestia/sdk swagger --config? [config file] --project? [project file]
+  5. npx @nestia/sdk e2e --config? [config file] --project? [project file]
+  6. npx @nestia/sdk generate --config? [config file] --project? [project file]
+`;
+
+function halt(desc: string): never {
+  console.error(desc);
+  process.exit(-1);
+}
+
+function dependencies(argv: string[]): void {
+  // INSTALL DEPENDENCIES
+  const module = CommandParser.parse(argv).module ?? "npm";
+  const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
+
+  for (const lib of ["@nestia/fetcher", "typia"]) {
+    const command: string = `${prefix} ${lib}`;
+    console.log(`\n$ ${command}`);
+    cp.execSync(command, { stdio: "inherit" });
+  }
+}
+
+async function initialize(): Promise<void> {
+  if (fs.existsSync("nestia.config.ts") === true)
+    halt(
+      `Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
+    );
+  await fs.promises.copyFile(
+    `${__dirname}/../../assets/config/nestia.config.ts`,
+    "nestia.config.ts",
+  );
+}
+
+async function execute(
+  closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
+): Promise<void> {
+  const module = await import("./internal/NestiaSdkCommand");
+  await closure(module.NestiaSdkCommand);
+}
+
+async function main() {
+  const type: string | undefined = process.argv[2];
+  const argv: string[] = process.argv.slice(3);
+
+  if (type === "dependencies") dependencies(argv);
+  else if (type === "init") await initialize();
+  else if (type === "sdk") await execute((c) => c.sdk());
+  else if (type === "swagger") await execute((c) => c.swagger());
+  else if (type === "e2e") await execute((c) => c.e2e());
+  else if (type === "all") await execute((c) => c.all());
+  else halt(USAGE);
+
+  process.exit(0);
+}
+main().catch((exp) => {
+  console.log(exp);
+  process.exit(-1);
+});

package/src/generates/CloneGenerator.ts

@@ -1,66 +1,66 @@
-import fs from "fs";
-import ts from "typescript";
-
-import { INestiaProject } from "../structures/INestiaProject";
-import { ITypedApplication } from "../structures/ITypedApplication";
-import { FilePrinter } from "./internal/FilePrinter";
-import { ImportDictionary } from "./internal/ImportDictionary";
-import { SdkHttpCloneProgrammer } from "./internal/SdkHttpCloneProgrammer";
-import { SdkHttpCloneReferencer } from "./internal/SdkHttpCloneReferencer";
-
-export namespace CloneGenerator {
-  export const write = async (app: ITypedApplication): Promise<void> => {
-    const dict: Map<string, SdkHttpCloneProgrammer.IModule> =
-      SdkHttpCloneProgrammer.write(app);
-    if (dict.size === 0) return;
-
-    SdkHttpCloneReferencer.replace(app);
-    try {
-      await fs.promises.mkdir(`${app.project.config.output}/structures`);
-    } catch {}
-    for (const [key, value] of dict)
-      await writeDtoFile(app.project)(key, value);
-  };
-
-  const writeDtoFile =
-    (project: INestiaProject) =>
-    async (
-      key: string,
-      value: SdkHttpCloneProgrammer.IModule,
-    ): Promise<void> => {
-      const location: string = `${project.config.output}/structures/${key}.ts`;
-      const importer: ImportDictionary = new ImportDictionary(location);
-      const statements: ts.Statement[] = iterate(importer)(value);
-      if (statements.length === 0) return;
-
-      await FilePrinter.write({
-        location,
-        statements: [
-          ...importer.toStatements(`${project.config.output}/structures`),
-          ...(importer.empty() ? [] : [FilePrinter.enter()]),
-          ...statements,
-        ],
-      });
-    };
-
-  const iterate =
-    (importer: ImportDictionary) =>
-    (modulo: SdkHttpCloneProgrammer.IModule): ts.Statement[] => {
-      const output: ts.Statement[] = [];
-      if (modulo.programmer !== null) output.push(modulo.programmer(importer));
-      if (modulo.children.size) {
-        const internal: ts.Statement[] = [];
-        for (const child of modulo.children.values())
-          internal.push(...iterate(importer)(child));
-        output.push(
-          ts.factory.createModuleDeclaration(
-            [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
-            ts.factory.createIdentifier(modulo.name),
-            ts.factory.createModuleBlock(internal),
-            ts.NodeFlags.Namespace,
-          ),
-        );
-      }
-      return output;
-    };
-}
+import fs from "fs";
+import ts from "typescript";
+
+import { INestiaProject } from "../structures/INestiaProject";
+import { ITypedApplication } from "../structures/ITypedApplication";
+import { FilePrinter } from "./internal/FilePrinter";
+import { ImportDictionary } from "./internal/ImportDictionary";
+import { SdkHttpCloneProgrammer } from "./internal/SdkHttpCloneProgrammer";
+import { SdkHttpCloneReferencer } from "./internal/SdkHttpCloneReferencer";
+
+export namespace CloneGenerator {
+  export const write = async (app: ITypedApplication): Promise<void> => {
+    const dict: Map<string, SdkHttpCloneProgrammer.IModule> =
+      SdkHttpCloneProgrammer.write(app);
+    if (dict.size === 0) return;
+
+    SdkHttpCloneReferencer.replace(app);
+    try {
+      await fs.promises.mkdir(`${app.project.config.output}/structures`);
+    } catch {}
+    for (const [key, value] of dict)
+      await writeDtoFile(app.project)(key, value);
+  };
+
+  const writeDtoFile =
+    (project: INestiaProject) =>
+    async (
+      key: string,
+      value: SdkHttpCloneProgrammer.IModule,
+    ): Promise<void> => {
+      const location: string = `${project.config.output}/structures/${key}.ts`;
+      const importer: ImportDictionary = new ImportDictionary(location);
+      const statements: ts.Statement[] = iterate(importer)(value);
+      if (statements.length === 0) return;
+
+      await FilePrinter.write({
+        location,
+        statements: [
+          ...importer.toStatements(`${project.config.output}/structures`),
+          ...(importer.empty() ? [] : [FilePrinter.enter()]),
+          ...statements,
+        ],
+      });
+    };
+
+  const iterate =
+    (importer: ImportDictionary) =>
+    (modulo: SdkHttpCloneProgrammer.IModule): ts.Statement[] => {
+      const output: ts.Statement[] = [];
+      if (modulo.programmer !== null) output.push(modulo.programmer(importer));
+      if (modulo.children.size) {
+        const internal: ts.Statement[] = [];
+        for (const child of modulo.children.values())
+          internal.push(...iterate(importer)(child));
+        output.push(
+          ts.factory.createModuleDeclaration(
+            [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
+            ts.factory.createIdentifier(modulo.name),
+            ts.factory.createModuleBlock(internal),
+            ts.NodeFlags.Namespace,
+          ),
+        );
+      }
+      return output;
+    };
+}