@nestia/sdk 5.0.0 → 6.0.0-dev.20250406

package/src/executable/internal/NestiaSdkCommand.ts

@@ -1,103 +1,103 @@
-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 laest 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 laest 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;
+    };
+}

package/src/generates/E2eGenerator.ts

@@ -1,32 +1,32 @@
-import fs from "fs";
-import path from "path";
-
-import { ITypedApplication } from "../structures/ITypedApplication";
-import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
-
-export namespace E2eGenerator {
-  export const generate = async (app: ITypedApplication): Promise<void> => {
-    console.log("Generating E2E Test Functions");
-
-    // PREPARE DIRECTORIES
-    const output: string = path.resolve(app.project.config.e2e!);
-    await mkdir(output);
-    await mkdir(path.join(output, "features"));
-    await mkdir(path.join(output, "features", "api"));
-    await mkdir(path.join(output, "features", "api", "automated"));
-
-    // GENERATE EACH TEST FILES
-    for (const route of app.routes)
-      if (route.protocol === "http")
-        await E2eFileProgrammer.generate(app.project)({
-          api: path.resolve(app.project.config.output!),
-          current: path.join(output, "features", "api", "automated"),
-        })(route);
-  };
-}
-
-const mkdir = async (location: string): Promise<void> => {
-  try {
-    await fs.promises.mkdir(location);
-  } catch {}
-};
+import fs from "fs";
+import path from "path";
+
+import { ITypedApplication } from "../structures/ITypedApplication";
+import { E2eFileProgrammer } from "./internal/E2eFileProgrammer";
+
+export namespace E2eGenerator {
+  export const generate = async (app: ITypedApplication): Promise<void> => {
+    console.log("Generating E2E Test Functions");
+
+    // PREPARE DIRECTORIES
+    const output: string = path.resolve(app.project.config.e2e!);
+    await mkdir(output);
+    await mkdir(path.join(output, "features"));
+    await mkdir(path.join(output, "features", "api"));
+    await mkdir(path.join(output, "features", "api", "automated"));
+
+    // GENERATE EACH TEST FILES
+    for (const route of app.routes)
+      if (route.protocol === "http")
+        await E2eFileProgrammer.generate(app.project)({
+          api: path.resolve(app.project.config.output!),
+          current: path.join(output, "features", "api", "automated"),
+        })(route);
+  };
+}
+
+const mkdir = async (location: string): Promise<void> => {
+  try {
+    await fs.promises.mkdir(location);
+  } catch {}
+};