@g1cloud/api-gen 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,22 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm build:*)",
+      "Bash(pnpm dev:*)",
+      "Bash(npx ts-node src/index.ts --source ./examples --out-dir ./test-output)",
+      "Bash(chmod:*)",
+      "Bash(node dist/index.js:*)",
+      "Bash(grep:*)",
+      "Bash(node -e:*)",
+      "Bash(pnpm add:*)",
+      "Bash(pnpm approve-builds:*)",
+      "Bash(pnpm bundle:*)",
+      "Bash(cat:*)",
+      "Bash(./dist/index.js:*)",
+      "Bash(node /Users/kimos/git/g1cloud-tool/api-gen/dist/index.js:*)",
+      "Bash(pnpm install:*)",
+      "Bash(timeout 3 node:*)",
+      "Bash(npm whoami:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a CLI tool that generates OpenAPI v3 YAML specifications from Spring Boot Java source code. It parses Java files, detects REST controllers, extracts endpoint information, and produces a valid OpenAPI spec.
+
+## Commands
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build (compiles TypeScript to dist/)
+pnpm build
+
+# Run in development mode
+pnpm dev -- --source ./examples --output ./test-output.yaml
+
+# Run the test command (uses example files)
+pnpm test
+```
+
+## Architecture
+
+The tool follows a pipeline architecture with four main stages:
+
+1. **Parsing** (`src/parser/`) - Uses `java-parser` library to parse Java source files into AST
+   - `javaParser.ts`: Recursively finds and parses `.java` files, extracting class metadata
+   - `astAnalyzer.ts`: Utility functions for querying the parsed AST
+
+2. **Analysis** (`src/analyzer/`) - Extracts API-relevant information from parsed classes
+   - `controllerAnalyzer.ts`: Orchestrates analysis, identifies `@RestController`/`@Controller` classes
+   - `parameterAnalyzer.ts`: Extracts `@RequestParam`, `@PathVariable`, `@RequestHeader`, `@RequestBody`
+   - `responseAnalyzer.ts`: Determines return types and generates response schemas
+   - `securityAnalyzer.ts`: Parses `@PreAuthorize`/`@PostAuthorize` SpEL expressions for roles
+   - `schemaGenerator.ts`: Recursively generates DTO schemas with validation annotations
+
+3. **Generation** (`src/generator/openapiGenerator.ts`) - Converts analyzed data to OpenAPI spec and writes YAML
+
+4. **Entry Point** (`src/index.ts`) - CLI using Commander, orchestrates the full pipeline
+
+### Key Data Flow
+
+```
+Java Files → JavaFileParser → JavaClass objects → ControllerAnalyzer → EndpointInfo objects → OpenAPIGenerator → YAML
+```
+
+### ProcessingContext
+
+The `ProcessingContext` type is passed through the pipeline and contains:
+- `javaClasses`: Map of parsed Java classes by name
+- `controllers`: Analyzed controller information
+- `dtoSchemas`: Generated schemas for DTOs
+- `referencedTypes`: Set of types that need schema generation
+
+## Special Type Handling
+
+The tool has built-in handling for:
+- **SearchParam**: Auto-adds pagination query params (offset, limit, filter, sort)
+- **PaginatedList<T>**: Adds pagination headers (X-Total-Count, X-Offset, X-Limit) and generates wrapper schema
+- **ResponseEntity<T>**: Unwraps the generic type for response schema generation

package/README.md

@@ -0,0 +1,379 @@
+# @g1cloud/api-gen
+
+Spring Boot Java 소스 코드에서 OpenAPI v3 YAML 스펙을 생성하는 CLI 도구입니다.
+
+## 기능
+
+- **Java 소스 파싱**: `java-parser`를 사용하여 Java 파일에서 클래스 및 메서드 정보 추출
+- **REST Controller 분석**: `@RestController`, `@Controller` 및 HTTP 매핑 어노테이션 감지
+- **파라미터 추출**: `@RequestParam`, `@PathVariable`, `@RequestHeader`, `@RequestBody` 지원
+- **응답 분석**: 반환 타입 추출 및 응답 스키마 생성
+- **보안 어노테이션 파싱**: `@PreAuthorize`, `@PostAuthorize`, `@Secured` 어노테이션 분석
+- **SpEL 표현식 파싱**: Spring Security 표현식에서 역할(role) 및 권한(authority) 추출
+- **DTO 스키마 생성**: 요청/응답 DTO에 대한 스키마 재귀적 생성
+- **특수 타입 처리**:
+  - `SearchParam`: 페이지네이션 파라미터 자동 추가 (offset, limit, filter, sort)
+  - `PaginatedList<T>`: 페이지네이션 헤더 추가 (X-Total-Count, X-Offset, X-Limit)
+
+## 설치
+
+```bash
+# 의존성 설치
+pnpm install
+
+# 프로젝트 빌드
+pnpm build
+
+# 또는 ts-node로 직접 실행
+pnpm dev -- --source ./examples --output ./test-output.yaml
+```
+
+## 사용법
+
+```bash
+# 기본 사용법 - 단일 통합 YAML 파일 생성
+npx spring-to-openapi --source ./src/main/java --output ./openapi.yaml
+
+# 컨트롤러별 모드 - 각 컨트롤러마다 별도 YAML 파일 생성
+npx spring-to-openapi --source ./src/main/java --out-dir ./api-docs
+
+# 모든 옵션 사용
+npx spring-to-openapi \
+  --source ./src/main/java \
+  --output ./openapi.yaml \
+  --title "My API" \
+  --api-version "1.0.0" \
+  --base-path "/api"
+```
+
+### CLI 옵션
+
+| 옵션 | 단축 | 설명 | 기본값 |
+|--------|-------|-------------|---------|
+| `--source` | `-s` | Java 소스 코드 디렉토리 경로 | (필수) |
+| `--output` | `-o` | 출력 YAML 파일 경로 (단일 통합 파일) | `openapi.yaml` |
+| `--out-dir` | `-d` | 출력 디렉토리 경로 (컨트롤러별 YAML 생성) | (없음) |
+| `--title` | `-t` | API 제목 | `API Documentation` |
+| `--api-version` | | API 버전 | `1.0.0` |
+| `--base-path` | `-b` | API 기본 경로 | (없음) |
+
+> **참고**: `--output`과 `--out-dir`은 상호 배타적입니다. 단일 통합 파일은 `--output`을, 컨트롤러별 YAML 파일 생성은 `--out-dir`을 사용하세요.
+
+## 예제
+
+### 입력: Java Controller
+
+```java
+@RestController
+@RequestMapping("/api/users")
+public class UserController {
+
+    @GetMapping
+    @PreAuthorize("hasRole('USER')")
+    public ResponseEntity<PaginatedList<UserDTO>> searchUsers(SearchParam searchParam) {
+        return ResponseEntity.ok(new PaginatedList<>());
+    }
+
+    @GetMapping("/{id}")
+    @PreAuthorize("hasAnyRole('USER', 'ADMIN')")
+    public ResponseEntity<UserDTO> getUserById(@PathVariable Long id) {
+        return ResponseEntity.ok(new UserDTO());
+    }
+
+    @PutMapping("/{id}")
+    @PreAuthorize("hasRole('ADMIN') or (#id == authentication.principal.id and hasRole('USER'))")
+    public ResponseEntity<UserDTO> updateUser(
+            @PathVariable Long id,
+            @Valid @RequestBody UpdateUserRequest request) {
+        return ResponseEntity.ok(new UserDTO());
+    }
+}
+```
+
+### 출력: OpenAPI YAML
+
+```yaml
+openapi: 3.0.0
+info:
+  title: My API
+  version: 1.0.0
+paths:
+  /api/users:
+    get:
+      summary: Search users
+      operationId: user_searchUsers
+      parameters:
+        - name: offset
+          in: query
+          schema:
+            type: integer
+          description: Pagination offset
+        - name: limit
+          in: query
+          schema:
+            type: integer
+          description: Pagination limit
+        - name: filter
+          in: query
+          schema:
+            $ref: '#/components/schemas/Filter'
+        - name: sort
+          in: query
+          schema:
+            $ref: '#/components/schemas/Sort'
+      responses:
+        '200':
+          description: Successful response
+          headers:
+            X-Total-Count:
+              schema:
+                type: integer
+              description: Total number of items
+            X-Offset:
+              schema:
+                type: integer
+              description: Current offset
+            X-Limit:
+              schema:
+                type: integer
+              description: Current limit
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PaginatedListUserDTO'
+      security:
+        - bearerAuth: []
+      x-required-roles:
+        - ROLE_USER
+
+  /api/users/{id}:
+    get:
+      summary: Get user by ID
+      operationId: user_getUserById
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+            format: int64
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserDTO'
+      security:
+        - bearerAuth: []
+      x-required-roles:
+        - ROLE_USER
+        - ROLE_ADMIN
+
+    put:
+      summary: Update user
+      operationId: user_updateUser
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+            format: int64
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateUserRequest'
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserDTO'
+      security:
+        - bearerAuth: []
+      x-required-roles:
+        - ROLE_ADMIN
+        - ROLE_USER
+      x-security-expression: "hasRole('ADMIN') or (#id == authentication.principal.id and hasRole('USER'))"
+
+components:
+  schemas:
+    UserDTO:
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int64
+        firstName:
+          type: string
+          minLength: 2
+          maxLength: 50
+        lastName:
+          type: string
+          minLength: 2
+          maxLength: 50
+        email:
+          type: string
+      required:
+        - firstName
+        - lastName
+        - email
+
+    Filter:
+      type: object
+      description: Filter conditions
+      additionalProperties: true
+
+    Sort:
+      type: object
+      description: Sort conditions
+      properties:
+        field:
+          type: string
+        direction:
+          type: string
+          enum:
+            - ASC
+            - DESC
+
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+```
+
+## 특수 타입 처리
+
+### SearchParam
+
+메서드 파라미터가 `SearchParam` 타입인 경우, 생성기가 자동으로 페이지네이션 쿼리 파라미터를 추가합니다:
+
+- `offset` (integer) - 페이지네이션 오프셋
+- `limit` (integer) - 페이지네이션 제한
+- `filter` (object) - 필터 조건 (Filter 스키마 참조)
+- `sort` (object) - 정렬 조건 (Sort 스키마 참조)
+
+### PaginatedList<T>
+
+메서드가 `PaginatedList<T>`를 반환하는 경우, 생성기가:
+
+1. 응답에 페이지네이션 헤더를 추가합니다:
+   - `X-Total-Count` - 전체 항목 수
+   - `X-Offset` - 현재 오프셋
+   - `X-Limit` - 현재 제한
+
+2. 다음 구조의 `PaginatedListT` 스키마를 생성합니다:
+   ```yaml
+   PaginatedListUserDTO:
+     type: object
+     properties:
+       items:
+         type: array
+         items:
+           $ref: '#/components/schemas/UserDTO'
+       total:
+         type: integer
+       offset:
+         type: integer
+       limit:
+         type: integer
+   ```
+
+### 보안 표현식
+
+생성기가 `@PreAuthorize` 및 `@PostAuthorize`의 SpEL 표현식을 파싱합니다:
+
+- `hasRole('ADMIN')` 같은 단순 표현식 → `x-required-roles: [ROLE_ADMIN]`
+- `hasAnyRole('USER', 'ADMIN')`의 다중 역할 → `x-required-roles: [ROLE_USER, ROLE_ADMIN]`
+- 복잡한 표현식은 `x-security-expression`에 보존
+
+## 유효성 검사 어노테이션
+
+생성기가 DTO 필드의 다음 유효성 검사 어노테이션을 인식합니다:
+
+| 어노테이션 | OpenAPI 매핑 |
+|------------|-----------------|
+| `@NotNull`, `@NotBlank`, `@NotEmpty` | `required: true` |
+| `@Size(min, max)` | `minLength`, `maxLength` |
+| `@Min(value)` | `minimum` |
+| `@Max(value)` | `maximum` |
+| `@Pattern(regexp)` | `pattern` |
+| `@Email` | `pattern` (이메일 정규식) |
+
+## 프로젝트 구조
+
+```
+api-gen/
+├── src/
+│   ├── index.ts                  # CLI 진입점
+│   ├── parser/
+│   │   ├── javaParser.ts         # Java 파일 파싱
+│   │   └── astAnalyzer.ts        # AST 분석 유틸리티
+│   ├── analyzer/
+│   │   ├── controllerAnalyzer.ts # Controller 감지
+│   │   ├── parameterAnalyzer.ts  # 파라미터 추출
+│   │   ├── responseAnalyzer.ts   # 응답 분석
+│   │   ├── securityAnalyzer.ts   # 보안 어노테이션 파싱
+│   │   └── schemaGenerator.ts    # DTO 스키마 생성
+│   ├── generator/
+│   │   └── openapiGenerator.ts   # OpenAPI YAML 생성
+│   └── types/
+│       └── index.ts              # TypeScript 타입 정의
+├── examples/                     # 샘플 Java 파일
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 개발
+
+```bash
+# 의존성 설치
+pnpm install
+
+# 개발 모드로 실행
+pnpm dev -- --source ./examples
+
+# 프로덕션 빌드
+pnpm build
+
+# 테스트 실행 (예제 파일 사용)
+pnpm test
+```
+
+# 실제 사용 예시
+
+```shell
+pnpm start --source /git/g1cloud2/g1cloud-sales --output ./out/g1cloud-sales.yaml --title "G1cloud Sales API" --api-version "2.0.0-SNAPSHOT"
+
+npx @redocly/cli build-docs ./out/g1cloud-sales.yaml -o ./out/g1cloud-sales.html
+```
+
+```shell
+pnpm start --source /git/g1cloud2/g1cloud-sales \
+    --api-source /git/g1cloud2/g1cloud-sales/g1cloud-sales-app \
+    --output ./out/g1cloud-sales-app.yaml \
+    --title "G1cloud Sales API" \
+    --api-version "2.0.0-SNAPSHOT"
+
+npx @redocly/cli build-docs \
+    ./out/g1cloud-sales-app.yaml \
+    -o ./out/g1cloud-sales-app.html
+```
+
+```shell
+pnpm start --source /git/g1cloud2/g1cloud-sales-service \
+    --api-source /git/g1cloud2/g1cloud-sales-service/module-basis \
+    --output ./out/g1cloud-sales-basis.yaml \
+    --title "G1cloud Sales Basis API" \
+    --api-version "2.0.0-SNAPSHOT"
+
+npx @redocly/cli build-docs \
+    ./out/g1cloud-sales-basis.yaml \
+    -o ./out/g1cloud-sales-basis.html
+```

package/dist/analyzer/controllerAnalyzer.d.ts

@@ -0,0 +1,20 @@
+import { ControllerInfo, ProcessingContext } from '../types';
+export declare class ControllerAnalyzer {
+    private context;
+    constructor(context: ProcessingContext);
+    /**
+     * Analyze all Java classes and extract controller information
+     * If apiSourcePath is specified, only analyze controllers within that directory
+     */
+    analyzeControllers(): ControllerInfo[];
+    /**
+     * Analyze a single controller class
+     */
+    private analyzeController;
+    /**
+     * Analyze a single endpoint method
+     */
+    private analyzeEndpoint;
+}
+export declare function analyzeControllers(context: ProcessingContext): ControllerInfo[];
+//# sourceMappingURL=controllerAnalyzer.d.ts.map

package/dist/analyzer/controllerAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllerAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/controllerAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAGd,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAMlB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAItC;;;OAGG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAqBtC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAwCxB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAG/E"}

package/dist/analyzer/controllerAnalyzer.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerAnalyzer = void 0;
+exports.analyzeControllers = analyzeControllers;
+const astAnalyzer_1 = require("../parser/astAnalyzer");
+const parameterAnalyzer_1 = require("./parameterAnalyzer");
+const responseAnalyzer_1 = require("./responseAnalyzer");
+const securityAnalyzer_1 = require("./securityAnalyzer");
+class ControllerAnalyzer {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Analyze all Java classes and extract controller information
+     * If apiSourcePath is specified, only analyze controllers within that directory
+     */
+    analyzeControllers() {
+        const controllers = [];
+        const { apiSourcePath } = this.context;
+        for (const [, javaClass] of this.context.javaClasses) {
+            // If apiSourcePath is specified, only include controllers from that directory
+            if (apiSourcePath && !javaClass.filePath.startsWith(apiSourcePath)) {
+                continue;
+            }
+            if (astAnalyzer_1.ASTAnalyzer.isRestController(javaClass)) {
+                const controllerInfo = this.analyzeController(javaClass);
+                if (controllerInfo) {
+                    controllers.push(controllerInfo);
+                }
+            }
+        }
+        return controllers;
+    }
+    /**
+     * Analyze a single controller class
+     */
+    analyzeController(javaClass) {
+        const basePath = astAnalyzer_1.ASTAnalyzer.getClassBasePath(javaClass);
+        const endpoints = [];
+        console.log(`  Found controller: ${javaClass.name} (base path: ${basePath || '/'})`);
+        for (const method of javaClass.methods) {
+            if (astAnalyzer_1.ASTAnalyzer.isEndpointMethod(method)) {
+                const endpoint = this.analyzeEndpoint(javaClass, method, basePath);
+                if (endpoint) {
+                    endpoints.push(endpoint);
+                    console.log(`    - ${endpoint.method.toUpperCase()} ${endpoint.path}`);
+                }
+            }
+        }
+        if (endpoints.length === 0) {
+            return null;
+        }
+        return {
+            className: javaClass.name,
+            basePath,
+            endpoints,
+            javaClass,
+        };
+    }
+    /**
+     * Analyze a single endpoint method
+     */
+    analyzeEndpoint(javaClass, method, basePath) {
+        const httpMethod = astAnalyzer_1.ASTAnalyzer.getHttpMethod(method);
+        if (!httpMethod) {
+            return null;
+        }
+        const methodPath = astAnalyzer_1.ASTAnalyzer.getMethodPath(method);
+        const fullPath = astAnalyzer_1.ASTAnalyzer.combinePaths(basePath, methodPath);
+        // Get @param descriptions from javadoc
+        const paramDescriptions = method.javadocInfo?.params || {};
+        // Analyze parameters (pass javadoc @param descriptions)
+        const { parameters, requestBody, hasSearchParam } = (0, parameterAnalyzer_1.analyzeParameters)(method, this.context, paramDescriptions);
+        // Analyze response
+        const { responses, hasPaginatedList, paginatedListItemType } = (0, responseAnalyzer_1.analyzeResponse)(method, this.context);
+        // Analyze security
+        const security = (0, securityAnalyzer_1.analyzeMethodSecurity)(method);
+        return {
+            path: fullPath,
+            method: httpMethod,
+            operationId: astAnalyzer_1.ASTAnalyzer.generateOperationId(javaClass.name, method.name),
+            summary: astAnalyzer_1.ASTAnalyzer.generateSummary(method.name),
+            description: method.javadoc,
+            returnDescription: method.javadocInfo?.returns,
+            parameters,
+            requestBody,
+            responses,
+            security,
+            hasSearchParam,
+            hasPaginatedList,
+            paginatedListItemType,
+        };
+    }
+}
+exports.ControllerAnalyzer = ControllerAnalyzer;
+function analyzeControllers(context) {
+    const analyzer = new ControllerAnalyzer(context);
+    return analyzer.analyzeControllers();
+}
+//# sourceMappingURL=controllerAnalyzer.js.map

package/dist/analyzer/controllerAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllerAnalyzer.js","sourceRoot":"","sources":["../../src/analyzer/controllerAnalyzer.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/parameterAnalyzer.d.ts

@@ -0,0 +1,19 @@
+import { JavaMethod, ParameterInfo, RequestBodyInfo, ProcessingContext, SchemaInfo } from '../types';
+interface ParameterAnalysisResult {
+    parameters: ParameterInfo[];
+    requestBody?: RequestBodyInfo;
+    hasSearchParam: boolean;
+}
+/**
+ * Analyze method parameters and extract OpenAPI parameter/request body info
+ * @param method The Java method to analyze
+ * @param context Processing context
+ * @param paramDescriptions Javadoc @param descriptions (param name -> description)
+ */
+export declare function analyzeParameters(method: JavaMethod, context: ProcessingContext, paramDescriptions?: Record<string, string>): ParameterAnalysisResult;
+/**
+ * Create a schema for a Java type
+ */
+export declare function createSchemaForType(javaType: string, genericType: string | undefined, context: ProcessingContext): SchemaInfo;
+export {};
+//# sourceMappingURL=parameterAnalyzer.d.ts.map

package/dist/analyzer/parameterAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/parameterAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAGV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAC;AAGlB,UAAU,uBAAuB;IAC/B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,iBAAiB,EAC1B,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC7C,uBAAuB,CAiCzB;AAkID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,iBAAiB,GACzB,UAAU,CA4CZ"}