@nestia/editor 12.0.0-rc.2 → 12.0.0-rc.4

package/src/internal/NestiaEditorComposer.ts

@@ -1,89 +1,89 @@
-import migrate from "@nestia/migrate";
-import type { NestiaMigrateApplication } from "@nestia/migrate";
-import {
-  OpenApiV3,
-  OpenApiV3_1,
-  OpenApiV3_2,
-  SwaggerV2,
-} from "@typia/interface";
-import * as prettierEsTreePlugin from "prettier/plugins/estree";
-import * as prettierTsPlugin from "prettier/plugins/typescript";
-import { format } from "prettier/standalone";
-import { IValidation } from "typia";
-
-export namespace NestiaEditorComposer {
-  export interface IProps {
-    document:
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApiV3_2.IDocument;
-    e2e: boolean;
-    keyword: boolean;
-    simulate: boolean;
-    package?: string;
-    /** @internal */
-    files?: Record<string, string>;
-  }
-  export interface IOutput {
-    files: Record<string, string>;
-    openFile: string;
-    startScript: string[];
-  }
-
-  export const nest = (props: IProps): Promise<IValidation<IOutput>> =>
-    compose({
-      openFile: "README.md,test/start.ts",
-      startScript: ["build:test,test", ""],
-      migrate: (app) => app.nest(props),
-    })(props);
-
-  export const sdk = async (props: IProps): Promise<IValidation<IOutput>> =>
-    compose({
-      openFile: "README.md,test/start.ts",
-      startScript: ["swagger", "hello"],
-      migrate: (app) => app.sdk(props),
-    })(props);
-
-  const compose =
-    (config: {
-      openFile: string;
-      startScript: string[];
-      migrate: (app: NestiaMigrateApplication) => Record<string, string>;
-    }) =>
-    async (props: IProps): Promise<IValidation<IOutput>> => {
-      if (props.files !== undefined)
-        return {
-          success: true,
-          data: {
-            files: props.files,
-            openFile: config.openFile,
-            startScript: config.startScript,
-          },
-        };
-      const result: IValidation<NestiaMigrateApplication> =
-        await migrate.NestiaMigrateApplication.validate(props.document);
-      if (result.success === false) return result;
-
-      const app: NestiaMigrateApplication = result.data;
-      const files: Record<string, string> = config.migrate(app);
-      for (const [key, value] of Object.entries(files))
-        if (key.substring(key.length - 3) === ".ts")
-          try {
-            files[key] = await format(value, {
-              parser: "typescript",
-              plugins: [prettierEsTreePlugin, prettierTsPlugin],
-            });
-          } catch (exp) {
-            console.log(exp);
-          }
-      return {
-        success: true,
-        data: {
-          files,
-          openFile: config.openFile,
-          startScript: config.startScript,
-        },
-      } satisfies IValidation<IOutput>;
-    };
-}
+import migrate from "@nestia/migrate";
+import type { NestiaMigrateApplication } from "@nestia/migrate";
+import {
+  OpenApiV3,
+  OpenApiV3_1,
+  OpenApiV3_2,
+  SwaggerV2,
+} from "@typia/interface";
+import * as prettierEsTreePlugin from "prettier/plugins/estree";
+import * as prettierTsPlugin from "prettier/plugins/typescript";
+import { format } from "prettier/standalone";
+import { IValidation } from "typia";
+
+export namespace NestiaEditorComposer {
+  export interface IProps {
+    document:
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApiV3_2.IDocument;
+    e2e: boolean;
+    keyword: boolean;
+    simulate: boolean;
+    package?: string;
+    /** @internal */
+    files?: Record<string, string>;
+  }
+  export interface IOutput {
+    files: Record<string, string>;
+    openFile: string;
+    startScript: string[];
+  }
+
+  export const nest = (props: IProps): Promise<IValidation<IOutput>> =>
+    compose({
+      openFile: "README.md,test/start.ts",
+      startScript: ["build:test,test", ""],
+      migrate: (app) => app.nest(props),
+    })(props);
+
+  export const sdk = async (props: IProps): Promise<IValidation<IOutput>> =>
+    compose({
+      openFile: "README.md,test/start.ts",
+      startScript: ["swagger", "hello"],
+      migrate: (app) => app.sdk(props),
+    })(props);
+
+  const compose =
+    (config: {
+      openFile: string;
+      startScript: string[];
+      migrate: (app: NestiaMigrateApplication) => Record<string, string>;
+    }) =>
+    async (props: IProps): Promise<IValidation<IOutput>> => {
+      if (props.files !== undefined)
+        return {
+          success: true,
+          data: {
+            files: props.files,
+            openFile: config.openFile,
+            startScript: config.startScript,
+          },
+        };
+      const result: IValidation<NestiaMigrateApplication> =
+        await migrate.NestiaMigrateApplication.validate(props.document);
+      if (result.success === false) return result;
+
+      const app: NestiaMigrateApplication = result.data;
+      const files: Record<string, string> = config.migrate(app);
+      for (const [key, value] of Object.entries(files))
+        if (key.substring(key.length - 3) === ".ts")
+          try {
+            files[key] = await format(value, {
+              parser: "typescript",
+              plugins: [prettierEsTreePlugin, prettierTsPlugin],
+            });
+          } catch (exp) {
+            console.log(exp);
+          }
+      return {
+        success: true,
+        data: {
+          files,
+          openFile: config.openFile,
+          startScript: config.startScript,
+        },
+      } satisfies IValidation<IOutput>;
+    };
+}

package/src/internal/NestiaEditorFileUploader.tsx

@@ -1,65 +1,65 @@
-import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
-import { load } from "js-yaml";
-import React from "react";
-import FileUpload, { type ExtendedFileProps } from "react-mui-fileuploader";
-
-export function NestiaEditorFileUploader(
-  props: NestiaEditorFileUploader.IProps,
-) {
-  const [elements, setElements] = React.useState<ExtendedFileProps[]>([]);
-  const onChange = async (array: ExtendedFileProps[]) => {
-    if (array.length === 0) {
-      props.onChange(null, null);
-      return;
-    }
-    const file: ExtendedFileProps = array[array.length - 1]!;
-    const buffer: ArrayBuffer = await file.arrayBuffer();
-    const content: string = new TextDecoder().decode(buffer);
-    const extension: "json" | "yaml" = file.name.split(".").pop()! as
-      | "json"
-      | "yaml";
-
-    try {
-      const json:
-        | SwaggerV2.IDocument
-        | OpenApiV3.IDocument
-        | OpenApiV3_1.IDocument =
-        extension === "json" ? JSON.parse(content) : load(content);
-      props.onChange(json, null);
-    } catch {
-      props.onChange(
-        null,
-        extension === "json" ? "Invalid JSON file" : "Invalid YAML file",
-      );
-      return;
-    }
-    if (array.length > 1) setElements([file]);
-  };
-  return (
-    <FileUpload
-      defaultFiles={elements}
-      onFilesChange={onChange}
-      acceptedType=".json, .yaml"
-      getBase64={false}
-      multiFile={false}
-      maxUploadFiles={1}
-      title="Swagger file uploader"
-      header="Drag and drop a Swagger file here"
-      buttonLabel="Click Here"
-      rightLabel="to select swagger.json/yaml file"
-      buttonRemoveLabel="Clear"
-    />
-  );
-}
-export namespace NestiaEditorFileUploader {
-  export interface IProps {
-    onChange: (
-      swagger:
-        | SwaggerV2.IDocument
-        | OpenApiV3.IDocument
-        | OpenApiV3_1.IDocument
-        | null,
-      error: string | null,
-    ) => void;
-  }
-}
+import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
+import { load } from "js-yaml";
+import React from "react";
+import FileUpload, { type ExtendedFileProps } from "react-mui-fileuploader";
+
+export function NestiaEditorFileUploader(
+  props: NestiaEditorFileUploader.IProps,
+) {
+  const [elements, setElements] = React.useState<ExtendedFileProps[]>([]);
+  const onChange = async (array: ExtendedFileProps[]) => {
+    if (array.length === 0) {
+      props.onChange(null, null);
+      return;
+    }
+    const file: ExtendedFileProps = array[array.length - 1]!;
+    const buffer: ArrayBuffer = await file.arrayBuffer();
+    const content: string = new TextDecoder().decode(buffer);
+    const extension: "json" | "yaml" = file.name.split(".").pop()! as
+      | "json"
+      | "yaml";
+
+    try {
+      const json:
+        | SwaggerV2.IDocument
+        | OpenApiV3.IDocument
+        | OpenApiV3_1.IDocument =
+        extension === "json" ? JSON.parse(content) : load(content);
+      props.onChange(json, null);
+    } catch {
+      props.onChange(
+        null,
+        extension === "json" ? "Invalid JSON file" : "Invalid YAML file",
+      );
+      return;
+    }
+    if (array.length > 1) setElements([file]);
+  };
+  return (
+    <FileUpload
+      defaultFiles={elements}
+      onFilesChange={onChange}
+      acceptedType=".json, .yaml"
+      getBase64={false}
+      multiFile={false}
+      maxUploadFiles={1}
+      title="Swagger file uploader"
+      header="Drag and drop a Swagger file here"
+      buttonLabel="Click Here"
+      rightLabel="to select swagger.json/yaml file"
+      buttonRemoveLabel="Clear"
+    />
+  );
+}
+export namespace NestiaEditorFileUploader {
+  export interface IProps {
+    onChange: (
+      swagger:
+        | SwaggerV2.IDocument
+        | OpenApiV3.IDocument
+        | OpenApiV3_1.IDocument
+        | null,
+      error: string | null,
+    ) => void;
+  }
+}

package/src/main.tsx

@@ -1,10 +1,10 @@
-import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
-
-import { NestiaEditorApplication } from "./NestiaEditorApplication";
-
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
-    <NestiaEditorApplication />
-  </StrictMode>,
-);
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import { NestiaEditorApplication } from "./NestiaEditorApplication";
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <NestiaEditorApplication />
+  </StrictMode>,
+);

package/src/typings/react-mui-fileuploader.d.ts

@@ -1,27 +1,27 @@
-declare module "react-mui-fileuploader" {
-  import type { ComponentType } from "react";
-
-  export interface ExtendedFileProps extends File {
-    contentType?: string;
-    extension?: string;
-    lastModifiedDate?: Date;
-    path?: string;
-  }
-
-  export interface FileUploadProps {
-    acceptedType?: string;
-    buttonLabel?: string;
-    buttonRemoveLabel?: string;
-    defaultFiles?: ExtendedFileProps[];
-    getBase64?: boolean;
-    header?: string;
-    maxUploadFiles?: number;
-    multiFile?: boolean;
-    onFilesChange?: (files: ExtendedFileProps[]) => void;
-    rightLabel?: string;
-    title?: string;
-  }
-
-  const FileUpload: ComponentType<FileUploadProps>;
-  export default FileUpload;
-}
+declare module "react-mui-fileuploader" {
+  import type { ComponentType } from "react";
+
+  export interface ExtendedFileProps extends File {
+    contentType?: string;
+    extension?: string;
+    lastModifiedDate?: Date;
+    path?: string;
+  }
+
+  export interface FileUploadProps {
+    acceptedType?: string;
+    buttonLabel?: string;
+    buttonRemoveLabel?: string;
+    defaultFiles?: ExtendedFileProps[];
+    getBase64?: boolean;
+    header?: string;
+    maxUploadFiles?: number;
+    multiFile?: boolean;
+    onFilesChange?: (files: ExtendedFileProps[]) => void;
+    rightLabel?: string;
+    title?: string;
+  }
+
+  const FileUpload: ComponentType<FileUploadProps>;
+  export default FileUpload;
+}

package/src/vite-env.d.ts

@@ -1 +1 @@
-/// <reference types="vite/client" />
+/// <reference types="vite/client" />

package/README.md

@@ -1,93 +0,0 @@
-# Nestia
-![Nestia Logo](https://nestia.io/logo.png)
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)
-[![npm version](https://img.shields.io/npm/v/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
-[![Downloads](https://img.shields.io/npm/dm/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
-[![Build Status](https://github.com/samchon/nestia/workflows/test/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Atest)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://nestia.io/docs/)
-[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/nestia)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
-
-Nestia is a set of helper libraries for NestJS, supporting below features:
-
-  - `@nestia/core`:
-    - Super-fast/easy decorators
-    - Advanced WebSocket routes
-  - `@nestia/sdk`:
-    - Swagger generator, more evolved than ever
-    - SDK library generator for clients
-    - Mockup Simulator for client applications
-    - Automatic E2E test functions generator
-  - `@nestia/e2e`: Test program utilizing e2e test functions
-  - `@nestia/benchmark`: Benchmark program using e2e test functions
-  - `@nestia/editor`: Swagger-UI with Online TypeScript Editor
-  - [`@agentica`](https://github.com/wrtnlabs/agentica): Agentic AI library specialized in LLM function calling
-  - [`@autobe`](https://github.com/wrtnlabs/autobe): Vibe coding agent generating NestJS application
-  - `nestia`: Just CLI (command line interface) tool
-
-> [!NOTE]
-> 
-> - **Only one line** required, with pure TypeScript type
-> - Enhance performance **30x** up
->   - Runtime validator is **20,000x faster** than `class-validator`
->   - JSON serialization is **200x faster** than `class-transformer`
-> - Software Development Kit
->   - Collection of typed `fetch` functions with DTO structures like [tRPC](https://trpc.io/)
->   - Mockup simulator means embedded backend simulator in the SDK
->     - similar with [msw](https://mswjs.io/), but fully automated
-
-![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)
-
-> Left is NestJS server code, and right is client (frontend) code utilizing SDK
-
-
-
-
-## Sponsors and Backers
-Thanks for your support.
-
-Your donation would encourage `nestia` development.
-
-[![Backers](https://opencollective.com/nestia/backers.svg?avatarHeight=75&width=600)](https://opencollective.com/nestia)
-
-
-
-
-## Guide Documents
-Check out the document in the [website](https://nestia.io/docs/):
-
-### 🏠 Home
-  - [Introduction](https://nestia.io/docs/)
-  - [Setup](https://nestia.io/docs/setup/)
-  - [Pure TypeScript](https://nestia.io/docs/pure)
-
-### 📖 Features
-  - Core Library
-    - [`@WebSocketRoute`](https://nestia.io/docs/core/WebSocketRoute)
-    - [`@TypedRoute`](https://nestia.io/docs/core/TypedRoute/)
-    - [**`@TypedBody`**](https://nestia.io/docs/core/TypedBody/)
-    - [`@TypedParam`](https://nestia.io/docs/core/TypedParam/)
-    - [`@TypedQuery`](https://nestia.io/docs/core/TypedQuery/)
-    - [`@TypedFormData`](https://nestia.io/docs/core/TypedFormData/)
-    - [`@TypedHeaders`](https://nestia.io/docs/core/TypedHeaders/)
-    - [`@TypedException`](https://nestia.io/docs/core/TypedException/)
-  - Software Development Kit
-    - [SDK Builder](https://nestia.io/docs/sdk/)
-    - [Mockup Simulator](https://nestia.io/docs/sdk/simulate/)
-    - [E2E Test Functions](https://nestia.io/docs/sdk/e2e/)
-    - [Distribution](https://nestia.io/docs/sdk/distribute/)
-  - Swagger Document
-    - [Swagger Builder](https://nestia.io/docs/swagger/)
-    - [**AI Chatbot Development**](https://nestia.io/docs/swagger/chat/)
-    - [Cloud Swagger Editor](https://nestia.io/docs/swagger/editor/)
-    - [Documentation Strategy](https://nestia.io/docs/swagger/strategy/)
-  - E2E Testing
-    - [Why E2E Test?](https://nestia.io/docs/e2e/why/)
-    - [Test Program Development](https://nestia.io/docs/e2e/development/)
-    - [Performance Benchmark](https://nestia.io/docs/e2e/benchmark/)
-
-### 🔗 Appendix
-  - [API Documents](https://nestia.io/api)
-  - [⇲ Benchmark Result](https://github.com/samchon/nestia/tree/master/benchmark/results/11th%20Gen%20Intel(R)%20Core(TM)%20i5-1135G7%20%40%202.40GHz)
-  - [⇲ `dev.to` Articles](https://dev.to/samchon/series/22751)