@g1cloud/api-gen 1.0.0

package/examples/ProductDTO.java

@@ -0,0 +1,129 @@
+package com.example.api.dto;
+
+import javax.validation.constraints.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * Product Data Transfer Object
+ */
+public class ProductDTO {
+
+    private Long id;
+
+    @NotBlank
+    @Size(min = 2, max = 100)
+    private String name;
+
+    @Size(max = 2000)
+    private String description;
+
+    @NotNull
+    @Min(0)
+    private BigDecimal price;
+
+    @Min(0)
+    private Integer stockQuantity;
+
+    private String sku;
+
+    private String category;
+
+    private List<String> tags;
+
+    private Boolean active;
+
+    private LocalDateTime createdAt;
+
+    private LocalDateTime updatedAt;
+
+    // Getters and setters
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public BigDecimal getPrice() {
+        return price;
+    }
+
+    public void setPrice(BigDecimal price) {
+        this.price = price;
+    }
+
+    public Integer getStockQuantity() {
+        return stockQuantity;
+    }
+
+    public void setStockQuantity(Integer stockQuantity) {
+        this.stockQuantity = stockQuantity;
+    }
+
+    public String getSku() {
+        return sku;
+    }
+
+    public void setSku(String sku) {
+        this.sku = sku;
+    }
+
+    public String getCategory() {
+        return category;
+    }
+
+    public void setCategory(String category) {
+        this.category = category;
+    }
+
+    public List<String> getTags() {
+        return tags;
+    }
+
+    public void setTags(List<String> tags) {
+        this.tags = tags;
+    }
+
+    public Boolean getActive() {
+        return active;
+    }
+
+    public void setActive(Boolean active) {
+        this.active = active;
+    }
+
+    public LocalDateTime getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(LocalDateTime createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public LocalDateTime getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(LocalDateTime updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+}

package/examples/RoleDTO.java

@@ -0,0 +1,47 @@
+package com.example.api.dto;
+
+import java.util.List;
+
+/**
+ * Role Data Transfer Object
+ */
+public class RoleDTO {
+
+    private Long id;
+    private String name;
+    private String description;
+    private List<String> permissions;
+
+    // Getters and setters
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public List<String> getPermissions() {
+        return permissions;
+    }
+
+    public void setPermissions(List<String> permissions) {
+        this.permissions = permissions;
+    }
+}

package/examples/SearchParam.java

@@ -0,0 +1,55 @@
+package com.example.api.common;
+
+/**
+ * Search parameters for pagination and filtering
+ */
+public class SearchParam {
+
+    private Integer offset;
+    private Integer limit;
+    private Filter filter;
+    private Sort sort;
+
+    public SearchParam() {
+        this.offset = 0;
+        this.limit = 20;
+    }
+
+    public SearchParam(Integer offset, Integer limit) {
+        this.offset = offset;
+        this.limit = limit;
+    }
+
+    // Getters and setters
+    public Integer getOffset() {
+        return offset;
+    }
+
+    public void setOffset(Integer offset) {
+        this.offset = offset;
+    }
+
+    public Integer getLimit() {
+        return limit;
+    }
+
+    public void setLimit(Integer limit) {
+        this.limit = limit;
+    }
+
+    public Filter getFilter() {
+        return filter;
+    }
+
+    public void setFilter(Filter filter) {
+        this.filter = filter;
+    }
+
+    public Sort getSort() {
+        return sort;
+    }
+
+    public void setSort(Sort sort) {
+        this.sort = sort;
+    }
+}

package/examples/Sort.java

@@ -0,0 +1,70 @@
+package com.example.api.common;
+
+/**
+ * Sort conditions for search queries
+ */
+public class Sort {
+
+    private String field;
+    private Direction direction;
+
+    public enum Direction {
+        ASC,
+        DESC
+    }
+
+    public Sort() {
+        this.direction = Direction.ASC;
+    }
+
+    public Sort(String field) {
+        this.field = field;
+        this.direction = Direction.ASC;
+    }
+
+    public Sort(String field, Direction direction) {
+        this.field = field;
+        this.direction = direction;
+    }
+
+    // Static factory methods
+    public static Sort by(String field) {
+        return new Sort(field, Direction.ASC);
+    }
+
+    public static Sort asc(String field) {
+        return new Sort(field, Direction.ASC);
+    }
+
+    public static Sort desc(String field) {
+        return new Sort(field, Direction.DESC);
+    }
+
+    // Getters and setters
+    public String getField() {
+        return field;
+    }
+
+    public void setField(String field) {
+        this.field = field;
+    }
+
+    public Direction getDirection() {
+        return direction;
+    }
+
+    public void setDirection(Direction direction) {
+        this.direction = direction;
+    }
+
+    // Fluent API
+    public Sort ascending() {
+        this.direction = Direction.ASC;
+        return this;
+    }
+
+    public Sort descending() {
+        this.direction = Direction.DESC;
+        return this;
+    }
+}

package/examples/UpdateUserRequest.java

@@ -0,0 +1,74 @@
+package com.example.api.dto;
+
+import javax.validation.constraints.*;
+
+/**
+ * Request object for updating an existing user
+ */
+public class UpdateUserRequest {
+
+    @Size(min = 2, max = 50)
+    private String firstName;
+
+    @Size(min = 2, max = 50)
+    private String lastName;
+
+    @Email
+    private String email;
+
+    @Pattern(regexp = "^\\+?[1-9]\\d{1,14}$")
+    private String phoneNumber;
+
+    private Long departmentId;
+
+    private String status;
+
+    // Getters and setters
+    public String getFirstName() {
+        return firstName;
+    }
+
+    public void setFirstName(String firstName) {
+        this.firstName = firstName;
+    }
+
+    public String getLastName() {
+        return lastName;
+    }
+
+    public void setLastName(String lastName) {
+        this.lastName = lastName;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public String getPhoneNumber() {
+        return phoneNumber;
+    }
+
+    public void setPhoneNumber(String phoneNumber) {
+        this.phoneNumber = phoneNumber;
+    }
+
+    public Long getDepartmentId() {
+        return departmentId;
+    }
+
+    public void setDepartmentId(Long departmentId) {
+        this.departmentId = departmentId;
+    }
+
+    public String getStatus() {
+        return status;
+    }
+
+    public void setStatus(String status) {
+        this.status = status;
+    }
+}

package/examples/UserController.java

@@ -0,0 +1,98 @@
+package com.example.api.controller;
+
+import com.example.api.dto.UserDTO;
+import com.example.api.dto.CreateUserRequest;
+import com.example.api.dto.UpdateUserRequest;
+import com.example.api.common.SearchParam;
+import com.example.api.common.PaginatedList;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import javax.validation.Valid;
+import java.util.List;
+
+/**
+ * User management REST controller
+ */
+@RestController
+@RequestMapping("/api/users")
+public class UserController {
+
+    /**
+     * Search users with pagination
+     * Uses SearchParam for pagination and filtering
+     */
+    @GetMapping
+    @PreAuthorize("hasRole('USER')")
+    public ResponseEntity<PaginatedList<UserDTO>> searchUsers(SearchParam searchParam) {
+        // Implementation
+        return ResponseEntity.ok(new PaginatedList<>());
+    }
+
+    /**
+     * Get user by ID
+     */
+    @GetMapping("/{id}")
+    @PreAuthorize("hasAnyRole('USER', 'ADMIN')")
+    public ResponseEntity<UserDTO> getUserById(@PathVariable Long id) {
+        // Implementation
+        return ResponseEntity.ok(new UserDTO());
+    }
+
+    /**
+     * Create new user
+     */
+    @PostMapping
+    @PreAuthorize("hasRole('ADMIN')")
+    public ResponseEntity<UserDTO> createUser(@Valid @RequestBody CreateUserRequest request) {
+        // Implementation
+        return ResponseEntity.ok(new UserDTO());
+    }
+
+    /**
+     * Update existing user
+     * Complex security: admin can update anyone, users can only update themselves
+     */
+    @PutMapping("/{id}")
+    @PreAuthorize("hasRole('ADMIN') or (#id == authentication.principal.id and hasRole('USER'))")
+    public ResponseEntity<UserDTO> updateUser(
+            @PathVariable Long id,
+            @Valid @RequestBody UpdateUserRequest request) {
+        // Implementation
+        return ResponseEntity.ok(new UserDTO());
+    }
+
+    /**
+     * Delete user
+     */
+    @DeleteMapping("/{id}")
+    @PreAuthorize("hasRole('ADMIN')")
+    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
+        // Implementation
+        return ResponseEntity.ok().build();
+    }
+
+    /**
+     * Get users by department with optional status filter
+     */
+    @GetMapping("/department/{departmentId}")
+    @PreAuthorize("hasAuthority('READ_USERS')")
+    public ResponseEntity<List<UserDTO>> getUsersByDepartment(
+            @PathVariable Long departmentId,
+            @RequestParam(required = false, defaultValue = "ACTIVE") String status,
+            @RequestHeader("X-Tenant-ID") String tenantId) {
+        // Implementation
+        return ResponseEntity.ok(List.of());
+    }
+
+    /**
+     * Bulk import users
+     */
+    @PostMapping("/bulk")
+    @PreAuthorize("hasRole('ADMIN') and hasAuthority('BULK_IMPORT')")
+    public ResponseEntity<List<UserDTO>> bulkImportUsers(@RequestBody List<CreateUserRequest> requests) {
+        // Implementation
+        return ResponseEntity.ok(List.of());
+    }
+}

package/examples/UserDTO.java

@@ -0,0 +1,119 @@
+package com.example.api.dto;
+
+import javax.validation.constraints.*;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * User Data Transfer Object
+ */
+public class UserDTO {
+
+    private Long id;
+
+    @NotBlank
+    @Size(min = 2, max = 50)
+    private String firstName;
+
+    @NotBlank
+    @Size(min = 2, max = 50)
+    private String lastName;
+
+    @NotBlank
+    @Email
+    private String email;
+
+    @Pattern(regexp = "^\\+?[1-9]\\d{1,14}$")
+    private String phoneNumber;
+
+    private String status;
+
+    private LocalDateTime createdAt;
+
+    private LocalDateTime updatedAt;
+
+    private DepartmentDTO department;
+
+    private List<RoleDTO> roles;
+
+    // Getters and setters
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getFirstName() {
+        return firstName;
+    }
+
+    public void setFirstName(String firstName) {
+        this.firstName = firstName;
+    }
+
+    public String getLastName() {
+        return lastName;
+    }
+
+    public void setLastName(String lastName) {
+        this.lastName = lastName;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public String getPhoneNumber() {
+        return phoneNumber;
+    }
+
+    public void setPhoneNumber(String phoneNumber) {
+        this.phoneNumber = phoneNumber;
+    }
+
+    public String getStatus() {
+        return status;
+    }
+
+    public void setStatus(String status) {
+        this.status = status;
+    }
+
+    public LocalDateTime getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(LocalDateTime createdAt) {
+        this.createdAt = createdAt;
+    }
+
+    public LocalDateTime getUpdatedAt() {
+        return updatedAt;
+    }
+
+    public void setUpdatedAt(LocalDateTime updatedAt) {
+        this.updatedAt = updatedAt;
+    }
+
+    public DepartmentDTO getDepartment() {
+        return department;
+    }
+
+    public void setDepartment(DepartmentDTO department) {
+        this.department = department;
+    }
+
+    public List<RoleDTO> getRoles() {
+        return roles;
+    }
+
+    public void setRoles(List<RoleDTO> roles) {
+        this.roles = roles;
+    }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@g1cloud/api-gen",
+  "version": "1.0.0",
+  "description": "CLI tool to generate OpenAPI v3 YAML from Spring Boot Java source code",
+  "main": "dist/index.js",
+  "bin": {
+    "api-gen": "./dist/index.js",
+    "spring-to-openapi": "./dist/index.js",
+    "spring-to-openapi-mcp": "./dist/mcp-server.mjs"
+  },
+  "keywords": [
+    "openapi",
+    "swagger",
+    "spring-boot",
+    "java",
+    "api",
+    "generator",
+    "cli",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "author": "G1Cloud",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^12.1.0",
+    "java-parser": "^2.3.2",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.25"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "bundle": "tsup && chmod +x dist/index.js dist/mcp-server.mjs",
+    "start": "node dist/index.js",
+    "start:mcp": "node dist/mcp-server.mjs",
+    "dev": "ts-node src/index.ts",
+    "dev:mcp": "npx tsx src/mcp-server.ts",
+    "test": "ts-node src/index.ts --source ./examples --output ./test-output.yaml --title 'Test API' --api-version '1.0.0'"
+  }
+}