@autobe/compiler 0.29.2 → 0.30.0

package/src/{prisma/validatePrismaApplication.ts → database/validateDatabaseApplication.ts}

@@ -1,10 +1,10 @@
-import { AutoBePrisma, IAutoBePrismaValidation } from "@autobe/interface";
-import { MapUtil, StringUtil } from "@autobe/utils";
+import { AutoBeDatabase, IAutoBeDatabaseValidation } from "@autobe/interface";
+import { AutoBeEscaper, MapUtil, StringUtil } from "@autobe/utils";
 import { HashMap, hash } from "tstl";
 
-export function validatePrismaApplication(
-  application: AutoBePrisma.IApplication,
-): IAutoBePrismaValidation {
+export function validateDatabaseApplication(
+  application: AutoBeDatabase.IApplication,
+): IAutoBeDatabaseValidation {
   const dict: Map<string, IModelContainer> = new Map(
     application.files
       .map((file, fi) =>
@@ -23,7 +23,7 @@ export function validatePrismaApplication(
       )
       .flat(),
   );
-  const errors: IAutoBePrismaValidation.IError[] = [
+  const errors: IAutoBeDatabaseValidation.IError[] = [
     ...validateDuplicatedFiles(application),
     ...validateDuplicatedModels(application),
     ...application.files
@@ -33,8 +33,10 @@ export function validatePrismaApplication(
           return [
             ...validateDuplicatedFields(dict, model, accessor),
             ...validateDuplicatedIndexes(model, accessor),
+            ...validateValidNames(model, accessor),
             ...validateIndexes(model, accessor),
             ...validateReferences(model, accessor, dict),
+            ...validateDuplicatedRelationOppositeNames(dict, model),
           ];
         }),
       )
@@ -53,8 +55,8 @@ export function validatePrismaApplication(
 }
 
 interface IModelContainer {
-  file: AutoBePrisma.IFile;
-  model: AutoBePrisma.IModel;
+  file: AutoBeDatabase.IFile;
+  model: AutoBeDatabase.IModel;
   fileIndex: number;
   modelIndex: number;
 }
@@ -63,10 +65,10 @@ interface IModelContainer {
   DUPLICATES
 ----------------------------------------------------------- */
 function validateDuplicatedFiles(
-  app: AutoBePrisma.IApplication,
-): IAutoBePrismaValidation.IError[] {
+  app: AutoBeDatabase.IApplication,
+): IAutoBeDatabaseValidation.IError[] {
   interface IFileContainer {
-    file: AutoBePrisma.IFile;
+    file: AutoBeDatabase.IFile;
     index: number;
   }
   const group: Map<string, IFileContainer[]> = new Map();
@@ -75,7 +77,7 @@ function validateDuplicatedFiles(
     MapUtil.take(group, file.filename, () => []).push(container);
   });
 
-  const errors: IAutoBePrismaValidation.IError[] = [];
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
   for (const array of group.values())
     if (array.length !== 1)
       array.forEach((container, i) => {
@@ -99,8 +101,8 @@ function validateDuplicatedFiles(
 }
 
 function validateDuplicatedModels(
-  app: AutoBePrisma.IApplication,
-): IAutoBePrismaValidation.IError[] {
+  app: AutoBeDatabase.IApplication,
+): IAutoBeDatabaseValidation.IError[] {
   const modelContainers: Map<string, IModelContainer[]> = new Map();
   app.files.forEach((file, fileIndex) => {
     file.models.forEach((model, modelIndex) => {
@@ -114,7 +116,7 @@ function validateDuplicatedModels(
     });
   });
 
-  const errors: IAutoBePrismaValidation.IError[] = [];
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
   for (const array of modelContainers.values())
     if (array.length !== 1)
       array.forEach((container, i) => {
@@ -142,10 +144,10 @@ function validateDuplicatedModels(
 
 function validateDuplicatedFields(
   dict: Map<string, IModelContainer>,
-  model: AutoBePrisma.IModel,
+  model: AutoBeDatabase.IModel,
   accessor: string,
-): IAutoBePrismaValidation.IError[] {
-  const errors: IAutoBePrismaValidation.IError[] = [];
+): IAutoBeDatabaseValidation.IError[] {
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
 
   // FIND DUPLICATED FIELDS
   const group: Map<string, string[]> = new Map();
@@ -231,10 +233,10 @@ function validateDuplicatedFields(
 }
 
 function validateDuplicatedIndexes(
-  model: AutoBePrisma.IModel,
+  model: AutoBeDatabase.IModel,
   accessor: string,
-): IAutoBePrismaValidation.IError[] {
-  const errors: IAutoBePrismaValidation.IError[] = [];
+): IAutoBeDatabaseValidation.IError[] {
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
 
   // FIND DUPLICATED INDEXES
   const group: HashMap<string[], string[]> = new HashMap(
@@ -415,7 +417,7 @@ function validateDuplicatedIndexes(
     new Set(model.ginIndexes.map((g) => g.fieldName)).size
   )
     errors.push({
-      path: `${accessor}.ginIndexes[].fieldName`,
+      path: `${accessor}.ginIndexes`,
       table: model.name,
       field: null,
       message: StringUtil.trim`
@@ -430,13 +432,211 @@ function validateDuplicatedIndexes(
   return errors;
 }
 
+function validateDuplicatedRelationOppositeNames(
+  dict: Map<string, IModelContainer>,
+  model: AutoBeDatabase.IModel,
+): IAutoBeDatabaseValidation.IError[] {
+  interface IOppositeNameContainer {
+    container: IModelContainer;
+    foreignField: AutoBeDatabase.IForeignField;
+    foreignFieldIndex: number;
+  }
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
+  const group: Map<string, IOppositeNameContainer[]> = new Map();
+
+  // Collect all field/relation names in the target model
+  const targetFieldNames = new Set<string>([
+    model.primaryField.name,
+    ...model.foreignFields.map((f) => f.name),
+    ...model.foreignFields.map((f) => f.relation.name),
+    ...model.plainFields.map((f) => f.name),
+  ]);
+
+  for (const c of dict.values()) {
+    c.model.foreignFields.forEach((ff, i) => {
+      if (ff.relation.targetModel !== model.name) return;
+      MapUtil.take(group, ff.relation.oppositeName, () => []).push({
+        container: c,
+        foreignField: ff,
+        foreignFieldIndex: i,
+      });
+    });
+  }
+
+  // Check oppositeName conflicts with target model's existing fields
+  for (const [oppositeName, array] of group) {
+    if (targetFieldNames.has(oppositeName)) {
+      array.forEach((item) => {
+        const c = item.container;
+        const ff = item.foreignField;
+        errors.push({
+          path: `application.files[${c.fileIndex}].models[${c.modelIndex}].foreignFields[${item.foreignFieldIndex}].relation.oppositeName`,
+          table: c.model.name,
+          field: ff.name,
+          message: StringUtil.trim`
+            oppositeName "${oppositeName}" conflicts with existing field in target model "${model.name}".
+
+            **What happened?**
+            The oppositeName "${oppositeName}" would create a reverse relation property in "${model.name}",
+            but "${model.name}" already has a field or relation with that name.
+
+            **Why is this a problem?**
+            - Prisma cannot have two properties with the same name in a model
+            - This will cause Prisma schema compilation errors
+            - The reverse relation would overwrite or conflict with the existing field
+
+            **How to fix:**
+            Choose a different oppositeName that doesn't conflict with existing fields in "${model.name}".
+
+            **Naming suggestions:**
+            - Add a descriptive prefix/suffix: "${oppositeName}List", "${oppositeName}Items", "related${oppositeName.charAt(0).toUpperCase() + oppositeName.slice(1)}"
+            - Use the source model name: "${c.model.name.replace(/_/g, "").toLowerCase()}s"
+          `,
+        });
+      });
+    }
+  }
+
+  // Check duplicate oppositeNames among relations targeting the same model
+  for (const [oppositeName, array] of group) {
+    if (array.length === 1) continue;
+    array.forEach((item, i) => {
+      const c = item.container;
+      const ff = item.foreignField;
+      errors.push({
+        path: `application.files[${c.fileIndex}].models[${c.modelIndex}].foreignFields[${item.foreignFieldIndex}].relation.oppositeName`,
+        table: c.model.name,
+        field: ff.name,
+        message: StringUtil.trim`
+          Duplicated relation oppositeName "${oppositeName}" detected on target model "${model.name}".
+
+          **What is oppositeName?**
+          In Prisma relations, oppositeName defines the name of the reverse relation field
+          on the target model. It allows the target model to access related records through
+          this named property.
+
+          **Current situation:**
+          Multiple foreign key fields from different models are trying to create reverse
+          relations on "${model.name}" with the same oppositeName "${oppositeName}".
+
+          **Conflicting relations:**
+          ${array
+            .filter((_, j) => i !== j)
+            .map(
+              (oppo) =>
+                `- Model "${oppo.container.model.name}", field "${oppo.foreignField.name}" (accessor: application.files[${oppo.container.fileIndex}].models[${oppo.container.modelIndex}].foreignFields[${oppo.foreignFieldIndex}].relation.oppositeName)`,
+            )
+            .join("\n")}
+
+          **Why is this a problem?**
+          - Prisma requires unique relation names within a model
+          - When "${model.name}" tries to access related records, it won't know which relation to use
+          - This will cause Prisma schema compilation errors
+
+          **How to fix:**
+          Each relation pointing to "${model.name}" must have a unique oppositeName.
+
+          **Naming suggestions:**
+          - Use descriptive names that indicate the relationship's purpose
+          - Include the source model name for clarity
+          - Examples:
+            - Instead of both using "orders", use "customerOrders" and "sellerOrders"
+            - Instead of both using "users", use "createdByUser" and "assignedToUser"
+            - For "${c.model.name}" → "${model.name}": consider "${c.model.name.charAt(0).toLowerCase() + c.model.name.slice(1)}s" or a more descriptive name
+
+          Please rename the oppositeName to be unique across all relations targeting "${model.name}".
+        `,
+      });
+    });
+  }
+  return errors;
+}
+
 /* -----------------------------------------------------------
   VALIDATIONS
 ----------------------------------------------------------- */
+function validateValidNames(
+  model: AutoBeDatabase.IModel,
+  accessor: string,
+): IAutoBeDatabaseValidation.IError[] {
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
+  const validate = (props: {
+    value: string;
+    accessor: string;
+    field: string | null;
+  }): void => {
+    if (AutoBeEscaper.reserved(props.value))
+      errors.push({
+        path: props.accessor,
+        table: model.name,
+        field: props.field,
+        message: StringUtil.trim`
+        The name "${props.value}" is a system reserved keyword and cannot be used.
+      `,
+      });
+    else if (AutoBeEscaper.variable(props.value) === false)
+      errors.push({
+        path: props.accessor,
+        table: model.name,
+        field: props.field,
+        message: StringUtil.trim`
+        The name "${props.value}" is not a valid identifier.
+
+        Change to a valid identifier which can be a variable name in programming languages.
+      `,
+      });
+  };
+
+  // TABLE NAME
+  validate({
+    value: model.name,
+    accessor: `${accessor}.name`,
+    field: null,
+  });
+
+  // FIELDS
+  validate({
+    value: model.primaryField.name,
+    accessor: `${accessor}.primaryField.name`,
+    field: model.primaryField.name,
+  });
+  model.foreignFields.forEach((ff, i) => {
+    validate({
+      value: ff.name,
+      accessor: `${accessor}.foreignFields[${i}].name`,
+      field: ff.name,
+    });
+    validate({
+      value: ff.relation.name,
+      accessor: `${accessor}.foreignFields[${i}].relation.name`,
+      field: ff.name,
+    });
+    validate({
+      value: ff.relation.oppositeName,
+      accessor: `${accessor}.foreignFields[${i}].relation.oppositeName`,
+      field: ff.name,
+    });
+    if (ff.relation.mappingName)
+      validate({
+        value: ff.relation.mappingName,
+        accessor: `${accessor}.foreignFields[${i}].relation.mappingName`,
+        field: ff.name,
+      });
+  });
+  model.plainFields.forEach((pf, i) =>
+    validate({
+      value: pf.name,
+      accessor: `${accessor}.plainFields[${i}].name`,
+      field: pf.name,
+    }),
+  );
+  return errors;
+}
+
 function validateIndexes(
-  model: AutoBePrisma.IModel,
+  model: AutoBeDatabase.IModel,
   accessor: string,
-): IAutoBePrismaValidation.IError[] {
+): IAutoBeDatabaseValidation.IError[] {
   // EMENSION
   model.uniqueIndexes = model.uniqueIndexes.filter(
     (unique) =>
@@ -449,7 +649,7 @@ function validateIndexes(
       plain.fieldNames[0] !== model.primaryField.name,
   );
 
-  const errors: IAutoBePrismaValidation.IError[] = [];
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
   const columnNames: Set<string> = new Set([
     model.primaryField.name,
     ...model.foreignFields.map((field) => field.name),
@@ -589,11 +789,11 @@ function validateIndexes(
 }
 
 function validateReferences(
-  model: AutoBePrisma.IModel,
+  model: AutoBeDatabase.IModel,
   accessor: string,
   dict: Map<string, IModelContainer>,
-): IAutoBePrismaValidation.IError[] {
-  const errors: IAutoBePrismaValidation.IError[] = [];
+): IAutoBeDatabaseValidation.IError[] {
+  const errors: IAutoBeDatabaseValidation.IError[] = [];
 
   model.foreignFields.forEach((field, i) => {
     // DUPLICATED NAME

package/src/index.ts

@@ -1,5 +1,5 @@
 export * from "./AutoBeCompiler";
-export * from "./prisma/AutoBePrismaCompiler";
+export * from "./database/AutoBeDatabaseCompiler";
 export * from "./interface/AutoBeInterfaceCompiler";
 export * from "./test/AutoBeTestCompiler";
 export * from "./AutoBeTypeScriptCompiler";

package/src/interface/AutoBeInterfaceCompiler.ts

@@ -1,7 +1,7 @@
 import { AutoBeOpenApi, IAutoBeInterfaceCompiler } from "@autobe/interface";
 import { invertOpenApiDocument, transformOpenApiDocument } from "@autobe/utils";
 import { NestiaMigrateApplication } from "@nestia/migrate";
-import { OpenApi } from "@samchon/openapi";
+import { OpenApi } from "typia";
 
 import { ArrayUtil } from "../utils/ArrayUtil";
 import { FilePrinter } from "../utils/FilePrinter";

package/src/raw/AutoBeCompilerCommonTemplate.ts

@@ -1,7 +1,7 @@
 export const AutoBeCompilerCommonTemplate: Record<string, string> = {
   ".eslintrc.cjs": "module.exports = {\n  root: true,\n  plugins: [\"@typescript-eslint\", \"deprecation\"],\n  extends: [\"plugin:@typescript-eslint/recommended\"],\n  parser: \"@typescript-eslint/parser\",\n  parserOptions: {\n    project: [\"tsconfig.json\", \"test/tsconfig.json\"],\n  },\n  overrides: [\n    {\n      files: [\"src/**/*.ts\", \"test/**/*.ts\"],\n      rules: {\n        \"@typescript-eslint/consistent-type-definitions\": \"off\",\n        \"@typescript-eslint/no-empty-function\": \"off\",\n        \"@typescript-eslint/no-empty-interface\": \"off\",\n        \"@typescript-eslint/no-explicit-any\": \"off\",\n        \"@typescript-eslint/no-inferrable-types\": \"off\",\n        \"@typescript-eslint/no-namespace\": \"off\",\n        \"@typescript-eslint/no-non-null-assertion\": \"off\",\n        \"@typescript-eslint/no-unused-expressions\": \"off\",\n        \"@typescript-eslint/no-unused-vars\": \"off\",\n        \"@typescript-eslint/no-var-requires\": \"off\",\n        \"@typescript-eslint/no-floating-promises\": \"error\",\n        \"@typescript-eslint/no-require-imports\": \"off\",\n        \"@typescript-eslint/no-empty-object-type\": \"off\",\n        \"@typescript-eslint/prefer-as-const\": \"off\",\n        \"prefer-as-const\": \"off\",\n      },\n    },\n  ],\n};\n",
-  ".gitignore": "./autobe/\nbin/\ndist/\nlib/\nnode_modules/\n\nprisma/migrations\nprisma/schema/migrations\nprisma/bbs.db\n\n*.DS_Store\n.env\n.npmrc\npackage-lock.json\npnpm-lock.yaml",
+  ".gitignore": "./autobe/\nbin/\ndist/\nlib/\nnode_modules/\n\nprisma/migrations\nprisma/schema/migrations\nprisma/bbs.db\nsrc/prisma\n\n*.DS_Store\n.env\n.npmrc\npackage-lock.json\npnpm-lock.yaml",
   "LICENSE": "MIT License\n\nCopyright (c) 2025 Wrtn Technologies\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.",
-  "README.md": "# AutoBE Generated Backend Server\n\n![AutoBE Logo](https://github.com/user-attachments/assets/a90d14be-fd50-4dc7-ae9d-ca66c2124f31)\n\nA backend repository generated by [`@autobe`](https://github.com/wrtnlabs/autobe).\n\nThis backend program was automatically generated using [`@autobe`](https://github.com/wrtnlabs/autobe), the AI vibe coding agent for backend servers of below stack.\n\n- TypeScript\n- NestJS / Nestia\n- Prisma\n- Postgres\n\n```mermaid\nflowchart\nsubgraph \"Backend Coding Agent\"\n  coder(\"Facade Controller\")\nend\nsubgraph \"Functional Agents\"\n  coder --\"Requirements Analysis\"--> analyze(\"{{ANALYSIS_EMOJI}} Analyze\")\n  coder --\"ERD\"--> prisma(\"{{PRISMA_EMOJI}} Prisma\")\n  coder --\"API Design\"--> interface(\"{{INTERFACE_EMOJI}} Interface\")\n  coder --\"Test Codes\" --> test(\"{{TEST_EMOJI}} Test\")\n  coder --\"Main Program\" --> realize(\"{{REALIZE_EMOJI}} Realize\")\nend\nsubgraph \"Compiler Feedback\"\n  prisma --\"validates\" --> prismaCompiler(\"Prisma Compiler\")\n  interface --\"validates\" --> openapiValidator(\"OpenAPI Validator\")\n  interface --\"generates\" --> tsCompiler(\"TypeScript Compiler\")\n  test --\"validates\" --> tsCompiler(\"TypeScript Compiler\")\n  realize --\"validates\" --> tsCompiler(\"TypeScript Compiler\")\nend\n```\n\nAlso, this backend application was built following [`@autobe`](https://github.com/wrtnlabs/autobe)'s waterfall development model, where each specialized AI agent handles a specific phase of development. The process ensures 100% working code through continuous compiler feedback and validation at every stage.\n\nEach agent receives input from previous phases and produces validated output that becomes the foundation for the next development stage. The **Facade Controller** orchestrates the entire process, while **Functional Agents** handle specialized tasks with built-in **Compiler Feedback** ensuring code quality and correctness.\n\nBelow table shows the mapping between waterfall phases, corresponding [`@autobe`](https://github.com/wrtnlabs/autobe) agents, and the actual deliverables you can find in this repository:\n\nWaterfall Model | AutoBe Agent | Result\n----------------|--------------|----------------------------------------------\nRequirements    | ✅ Facade       | Conversation History\nAnalysis        | {{ANALYSIS_EMOJI}} Analyze      | [Requirement Analysis Report](docs/analysis)\nDesign          | {{PRISMA_EMOJI}} Prisma       | [Entity Relationship Diagram](docs/ERD.md) / [Prisma Schema](prisma/schema)\nDesign          | {{INTERFACE_EMOJI}} Interface    | [API Controllers](src/controllers) / [DTO Structures](src/api/structures)\nDevelopment     | {{REALIZE_EMOJI}} Realize      | [API Provider Functions](src/providers)\nTesting         | {{TEST_EMOJI}} Test         | [E2E Test Functions](test/features/api)\nMaintenance     | -            | Use Claude Code like AI coding tool please\n\n## Project Structure\n\nThis template project has categorized directories like below.\n\nAs you can see from the below, all of the Backend source files are placed into the [src](src/) directory. When you build the TypeScript source files, compiled files would be placed into the `lib` directory following the [`tsconfig.json`](tsconfig.json) configuration. Otherwise you build client [SDK library](https://nestia.io/docs/sdk/) for npm publishing and their compiled files would be placed into the [`packages`](packages) directory.\n\n  - [`packages/api/`](packages/api): SDK module built by `npm run build:api`\n  - [`docs/`](docs/): Documentation directory\n    - [`docs/analysis`](docs/analysis/): Requirement Analysis report\n    - [`docs/ERD.md`](docs/ERD.md): Entity Relationship Diagram and detailed descriptions\n  - [`prisma/schema`](prisma/schema): Prisma ORM schema files\n  - [`src/`](src): Backend source directory\n    - [`src/api/`](src/api/): Client SDK that would be published to the `@ORGANIZATION/PROJECT-api`\n      - [`src/api/functional/`](src/api/functional/): API functions generated by the [`nestia`](https://github.com/samchon/nestia)\n      - [`src/api/structures/`](src/api/structures/): DTO structures\n    - [`src/controllers/`](src/controllers/): Controller classes of the Main Program\n    - [`src/providers/`](src/providers/): Implementations of the API functions\n  - [`test/`](test): Test Automation Program\n    - [`test/features`](test/features): List of test functions\n  - [`nestia.config.ts`](nestia.config.ts): Configuration file of [`nestia`](https://github.com/samchon/nestia)\n  - [`package.json`](package.json): NPM configuration\n  - [`tsconfig.json`](tsconfig.json): TypeScript configuration for the main program\n\n## NPM Run Commands\n\nList of the run commands defined in the [package.json](package.json) are like below:\n\n  - Test\n    - **`test`**: Run test automation program\n    - `benchmark`: Run performance benchmark program\n  - Build\n    - `build`: Build everything\n    - `build:main`: Build main program (`src` directory)\n    - `build:test` Build test automation program (`test` directory)\n    - `build:sdk`: Build SDK into main program only\n    - `build:swagger`: Build Swagger Documents\n    - **`dev`**: Incremental build for development (test program)\n  - Deploy\n    - `package:api`: Build and deploy the SDK library to the NPM\n    - `start`: Start the backend server\n    - `start:dev`: Start the backend server with incremental build and reload\n  - Webpack\n    - `webpack`: Run webpack bundler\n    - `webpack:start`: Start the backend server built by webpack\n    - `webpack:test`: Run test program to the webpack built\n\n## Specialization\n\nTransform this template project to be yours.\n\nWhen you've created a new backend project through this template project, you can specialize it to be suitable for you by changing some words. Replace below words through IDE specific function like `Edit > Replace in Files` (*Ctrl + Shift + H*), who've been supported by the VSCode.\n\n| Before       | After\n|--------------|----------------------------------------\n| ORGANIZATION | Your account or corporation name\n| PROJECT      | Your own project name\n| AUTHOR       | Author name\n| https://github.com/samchon/nestia-start | Your repository URL\n\n## Benchmark\n\n### Aggregate\n\nPhase | Generated | FCSR | Token Consumption | Elapsed Time\n------|-----------|------|-------------------|--------------\n{{BENCHMARK_AGGREGATE}}\n\nThis table shows the comprehensive metrics for each phase of the AutoBE generation pipeline. For each phase (Analyze, Prisma, Interface, Test, Realize), it tracks:\n\n- **Phase**: The pipeline phase with success (✅) or failure (❌) indicator\n- **Generated**: Count of artifacts produced (e.g., actors, documents, namespaces, models, operations, schemas, functions)\n- **FCSR**: Function calling success rate\n- **Token Consumption**: Total number of LLM tokens consumed during the phase\n- **Elapsed Time**: Wall-clock time taken to complete the phase, including all AI agent operations and compiler feedback loops\n\nThese aggregate metrics provide visibility into the computational cost and time requirements of the entire generation process, helping identify resource-intensive phases and overall pipeline efficiency.\n\n### Function Calling\n\nType | Trial | Validation Failure | JSON Parse Error | Success | Success Rate\n:----|------:|-------------------:|-----------------:|---------:|-------------:\n{{BENCHMARK_FUNCTION_CALLING}}\n\nThis table shows the reliability and quality metrics for AI agent function calling operations across all phases. Each row represents a specific operation type (e.g., `analyzeScenario`, `prismaSchema`, `realizeWrite`), tracking:\n\n- **Type**: The AI agent operation name\n- **Trial**: Total number of function calling attempts made by the agent\n- **Validation Failure**: Calls that produced valid JSON but failed type validation\n- **JSON Parse Error**: Calls that produced malformed JSON that couldn't be parsed\n- **Success**: Calls that completed successfully with valid, validated responses\n- **Success Rate**: Percentage of successful calls out of total attempts\n\nThese metrics reveal the effectiveness of AutoBE's validation feedback strategy powered by [`typia.llm.application<Class, Model>()`](https://typia.io/docs/llm/application/). When function calls fail type validation, detailed error messages are fed back to the AI agent, enabling iterative correction through self-healing spiral loops.\n\nSuccess rates vary based on model size and capability - smaller models may have lower initial success rates. However, validation feedback enables even weaker models to achieve high success rates through automatic correction cycles, demonstrating the power of compiler-driven development.\n\n## License\n\nAutoBE is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0)](https://github.com/wrtnlabs/autobe/?tab=AGPL-3.0-1-ov-file#readme). If you modify AutoBE itself or offer it as a network service, you must make your source code available under the same license.\n\nHowever, backend applications generated by AutoBE can be relicensed under any license you choose, such as MIT. This means you can freely use AutoBE-generated code in commercial projects without open source obligations, similar to how other code generation tools work.\n",
+  "README.md": "# AutoBE Generated Backend Server\n\n![AutoBE Logo](https://github.com/user-attachments/assets/a90d14be-fd50-4dc7-ae9d-ca66c2124f31)\n\nA backend repository generated by [`@autobe`](https://github.com/wrtnlabs/autobe).\n\nThis backend program was automatically generated using [`@autobe`](https://github.com/wrtnlabs/autobe), the AI vibe coding agent for backend servers of below stack.\n\n- TypeScript\n- NestJS / Nestia\n- Prisma\n- Postgres\n\n```mermaid\nflowchart\nsubgraph \"Backend Coding Agent\"\n  coder(\"Facade Controller\")\nend\nsubgraph \"Functional Agents\"\n  coder --\"Requirements Analysis\"--> analyze(\"{{ANALYSIS_EMOJI}} Analyze\")\n  coder --\"ERD\"--> database(\"{{DATABASE_EMOJI}} Database\")\n  coder --\"API Design\"--> interface(\"{{INTERFACE_EMOJI}} Interface\")\n  coder --\"Test Codes\" --> test(\"{{TEST_EMOJI}} Test\")\n  coder --\"Main Program\" --> realize(\"{{REALIZE_EMOJI}} Realize\")\nend\nsubgraph \"Compiler Feedback\"\n  database --\"validates\" --> prismaCompiler(\"Prisma Compiler\")\n  interface --\"validates\" --> openapiValidator(\"OpenAPI Validator\")\n  interface --\"generates\" --> tsCompiler(\"TypeScript Compiler\")\n  test --\"validates\" --> tsCompiler(\"TypeScript Compiler\")\n  realize --\"validates\" --> tsCompiler(\"TypeScript Compiler\")\nend\n```\n\nAlso, this backend application was built following [`@autobe`](https://github.com/wrtnlabs/autobe)'s waterfall development model, where each specialized AI agent handles a specific phase of development. The process ensures 100% working code through continuous compiler feedback and validation at every stage.\n\nEach agent receives input from previous phases and produces validated output that becomes the foundation for the next development stage. The **Facade Controller** orchestrates the entire process, while **Functional Agents** handle specialized tasks with built-in **Compiler Feedback** ensuring code quality and correctness.\n\nBelow table shows the mapping between waterfall phases, corresponding [`@autobe`](https://github.com/wrtnlabs/autobe) agents, and the actual deliverables you can find in this repository:\n\nWaterfall Model | AutoBe Agent | Result\n----------------|--------------|----------------------------------------------\nRequirements    | ✅ Facade       | Conversation History\nAnalysis        | {{ANALYSIS_EMOJI}} Analyze      | [Requirement Analysis Report](docs/analysis)\nDesign          | {{DATABASE_EMOJI}} Prisma       | [Entity Relationship Diagram](docs/ERD.md) / [Prisma Schema](prisma/schema)\nDesign          | {{INTERFACE_EMOJI}} Interface    | [API Controllers](src/controllers) / [DTO Structures](src/api/structures)\nDevelopment     | {{REALIZE_EMOJI}} Realize      | [API Provider Functions](src/providers)\nTesting         | {{TEST_EMOJI}} Test         | [E2E Test Functions](test/features/api)\nMaintenance     | -            | Use Claude Code like AI coding tool please\n\n## Project Structure\n\nThis template project has categorized directories like below.\n\nAs you can see from the below, all of the Backend source files are placed into the [src](src/) directory. When you build the TypeScript source files, compiled files would be placed into the `lib` directory following the [`tsconfig.json`](tsconfig.json) configuration. Otherwise you build client [SDK library](https://nestia.io/docs/sdk/) for npm publishing and their compiled files would be placed into the [`packages`](packages) directory.\n\n  - [`packages/api/`](packages/api): SDK module built by `npm run build:api`\n  - [`docs/`](docs/): Documentation directory\n    - [`docs/analysis`](docs/analysis/): Requirement Analysis report\n    - [`docs/ERD.md`](docs/ERD.md): Entity Relationship Diagram and detailed descriptions\n  - [`prisma/schema`](prisma/schema): Prisma ORM schema files\n  - [`src/`](src): Backend source directory\n    - [`src/api/`](src/api/): Client SDK that would be published to the `@ORGANIZATION/PROJECT-api`\n      - [`src/api/functional/`](src/api/functional/): API functions generated by the [`nestia`](https://github.com/samchon/nestia)\n      - [`src/api/structures/`](src/api/structures/): DTO structures\n    - [`src/controllers/`](src/controllers/): Controller classes of the Main Program\n    - [`src/providers/`](src/providers/): Implementations of the API functions\n  - [`test/`](test): Test Automation Program\n    - [`test/features`](test/features): List of test functions\n  - [`nestia.config.ts`](nestia.config.ts): Configuration file of [`nestia`](https://github.com/samchon/nestia)\n  - [`package.json`](package.json): NPM configuration\n  - [`tsconfig.json`](tsconfig.json): TypeScript configuration for the main program\n\n## NPM Run Commands\n\nList of the run commands defined in the [package.json](package.json) are like below:\n\n  - Test\n    - **`test`**: Run test automation program\n    - `benchmark`: Run performance benchmark program\n  - Build\n    - `build`: Build everything\n    - `build:main`: Build main program (`src` directory)\n    - `build:test` Build test automation program (`test` directory)\n    - `build:sdk`: Build SDK into main program only\n    - `build:swagger`: Build Swagger Documents\n    - **`dev`**: Incremental build for development (test program)\n  - Deploy\n    - `package:api`: Build and deploy the SDK library to the NPM\n    - `start`: Start the backend server\n    - `start:dev`: Start the backend server with incremental build and reload\n  - Webpack\n    - `webpack`: Run webpack bundler\n    - `webpack:start`: Start the backend server built by webpack\n    - `webpack:test`: Run test program to the webpack built\n\n## Specialization\n\nTransform this template project to be yours.\n\nWhen you've created a new backend project through this template project, you can specialize it to be suitable for you by changing some words. Replace below words through IDE specific function like `Edit > Replace in Files` (*Ctrl + Shift + H*), who've been supported by the VSCode.\n\n| Before       | After\n|--------------|----------------------------------------\n| ORGANIZATION | Your account or corporation name\n| PROJECT      | Your own project name\n| AUTHOR       | Author name\n| https://github.com/samchon/nestia-start | Your repository URL\n\n## Benchmark\n\n### Aggregate\n\nPhase | Generated | FCSR | Token Consumption | Elapsed Time\n------|-----------|------|-------------------|--------------\n{{BENCHMARK_AGGREGATE}}\n\nThis table shows the comprehensive metrics for each phase of the AutoBE generation pipeline. For each phase (Analyze, Database, Interface, Test, Realize), it tracks:\n\n- **Phase**: The pipeline phase with success (✅) or failure (❌) indicator\n- **Generated**: Count of artifacts produced (e.g., actors, documents, namespaces, models, operations, schemas, functions)\n- **FCSR**: Function calling success rate\n- **Token Consumption**: Total number of LLM tokens consumed during the phase\n- **Elapsed Time**: Wall-clock time taken to complete the phase, including all AI agent operations and compiler feedback loops\n\nThese aggregate metrics provide visibility into the computational cost and time requirements of the entire generation process, helping identify resource-intensive phases and overall pipeline efficiency.\n\n### Function Calling\n\nType | Trial | Validation Failure | JSON Parse Error | Success | Success Rate\n:----|------:|-------------------:|-----------------:|---------:|-------------:\n{{BENCHMARK_FUNCTION_CALLING}}\n\nThis table shows the reliability and quality metrics for AI agent function calling operations across all phases. Each row represents a specific operation type (e.g., `analyzeScenario`, `prismaSchema`, `realizeWrite`), tracking:\n\n- **Type**: The AI agent operation name\n- **Trial**: Total number of function calling attempts made by the agent\n- **Validation Failure**: Calls that produced valid JSON but failed type validation\n- **JSON Parse Error**: Calls that produced malformed JSON that couldn't be parsed\n- **Success**: Calls that completed successfully with valid, validated responses\n- **Success Rate**: Percentage of successful calls out of total attempts\n\nThese metrics reveal the effectiveness of AutoBE's validation feedback strategy powered by [`typia.llm.application<Class, Model>()`](https://typia.io/docs/llm/application/). When function calls fail type validation, detailed error messages are fed back to the AI agent, enabling iterative correction through self-healing spiral loops.\n\nSuccess rates vary based on model size and capability - smaller models may have lower initial success rates. However, validation feedback enables even weaker models to achieve high success rates through automatic correction cycles, demonstrating the power of compiler-driven development.\n\n## License\n\nAutoBE is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0)](https://github.com/wrtnlabs/autobe/?tab=AGPL-3.0-1-ov-file#readme). If you modify AutoBE itself or offer it as a network service, you must make your source code available under the same license.\n\nHowever, backend applications generated by AutoBE can be relicensed under any license you choose, such as MIT. This means you can freely use AutoBE-generated code in commercial projects without open source obligations, similar to how other code generation tools work.\n",
   "typos.toml": "[default]\nlocale = 'en-us'\nextend-ignore-re = [\n  \"(?Rm)^.*(<!--|#|//)\\\\s*spellchecker:disable-line(-->|\\n)?$\",\n  \".*(?:spellchecker|typos):\\\\s?ignore-next-line[^\\\\n]*\\\\n[^\\\\n]*\",\n  \"(?s)(<!--|#|//)\\\\s*spellchecker:off\\\\s*(-->|\\n).*?(<!--|#|//)\\\\s*spellchecker:on\",\n]\n\n[default.extend-words]\nJeongho = \"Jeongho\"\nNam = \"Nam\"\ntypia = \"typia\"\n\n[files]\nextend-exclude = [\"*.json\"]"
 };

package/src/raw/AutoBeCompilerInterfaceTemplate.ts

@@ -1,4 +1,6 @@
 export const AutoBeCompilerInterfaceTemplate: Record<string, string> = {
-  ".github/workflows/build.yml": "name: build\non:\n  pull_request:\n    paths:\n      - 'src/**'\n      - 'test/**'\n      - 'package.json'\njobs:\n  Ubuntu:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 20.x\n      - uses: pnpm/action-setup@v4\n        with:\n          version: 8\n      \n      - name: Install Backend-Server\n        run: pnpm install\n\n      - name: Build Swagger\n        run: pnpm run build:swagger\n\n      - name: Build SDK\n        run: pnpm run build:sdk\n\n      - name: Compile Backend-Server\n        run: pnpm run build\n\n      # - name: Run Test Program\n      #   run: pnpm run test -- --reset true --simultaneous 16\n\n      - name: EsLint\n        run: pnpm run eslint\n",
-  "test/tsconfig.json": "{\n  \"extends\": \"../tsconfig.json\",\n  \"compilerOptions\": {\n    \"outDir\": \"../bin\",\n    \"noUnusedLocals\": false,\n    \"noUnusedParameters\": false,\n  },\n  \"include\": [\".\", \"../src\"]\n}"
+  ".github/workflows/build.yml": "name: build\non:\n  pull_request:\n    paths:\n      - 'src/**'\n      - 'test/**'\n      - 'package.json'\njobs:\n  Ubuntu:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 20.x\n      - uses: pnpm/action-setup@v4\n        with:\n          version: 8\n      \n      - name: Install Backend-Server\n        run: pnpm install\n\n      - name: Build Swagger\n        run: pnpm run build:swagger\n\n      - name: Build SDK\n        run: pnpm run build:sdk\n\n      - name: Compile Backend-Server\n        run: pnpm run build\n\n      - name: Run Test Program\n        run: pnpm run test -- --reset true --simultaneous 16\n\n      - name: EsLint\n        run: pnpm run eslint\n",
+  "src/api/structures/IEntity.ts": "import { tags } from \"typia\";\n\n/** Just a base entity interface for referencing. */\nexport interface IEntity {\n  /** Primary Key. */\n  id: string & tags.Format<\"uuid\">;\n}\n",
+  "src/api/typings/DeepPartial.ts": "export type DeepPartial<T> = T extends\n  | string\n  | number\n  | boolean\n  | bigint\n  | symbol\n  | null\n  | undefined\n  ? T\n  : T extends (...args: unknown[]) => unknown\n    ? T\n    : T extends Array<infer U>\n      ? Array<DeepPartial<U>>\n      : T extends object\n        ? { [P in keyof T]?: DeepPartial<T[P]> }\n        : T;\n",
+  "test/tsconfig.json": "{\n  \"extends\": \"../tsconfig.json\",\n  \"compilerOptions\": {\n    \"baseUrl\": \"../\",\n    \"outDir\": \"../bin\",\n    \"noUnusedLocals\": false,\n    \"noUnusedParameters\": false,\n  },\n  \"include\": [\".\", \"../src\"]\n}"
 };