@fluojs/openapi 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fluo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,106 @@
+# @fluojs/openapi
+
+<p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
+
+fluo를 위한 데코레이터 기반 OpenAPI 3.1.0 문서 생성 패키지입니다. 별도의 수동 동기화 없이 API 문서를 자동으로 생성하고 제공하며, 선택적으로 Swagger UI를 지원합니다.
+
+## 목차
+
+- [설치](#설치)
+- [사용 시점](#사용-시점)
+- [빠른 시작](#빠른-시작)
+- [핵심 기능](#핵심-기능)
+- [공개 API](#공개-api)
+- [관련 패키지](#관련-패키지)
+- [예제 소스](#예제-소스)
+
+## 설치
+
+```bash
+pnpm add @fluojs/openapi
+```
+
+## 사용 시점
+
+- **Swagger UI**를 사용하여 REST API에 대한 대화형 문서를 제공하고 싶을 때.
+- 클라이언트 생성 또는 테스트를 위해 기계 읽기 가능한 **OpenAPI 3.1.0** 명세가 필요할 때.
+- 표준 데코레이터를 사용하여 API 문서와 코드를 동기화된 상태로 유지하고 싶을 때.
+- DTO 및 검증 메타데이터를 사용하여 복잡한 요청/응답 모델을 문서화해야 할 때.
+
+## 빠른 시작
+
+`OpenApiModule`을 등록하고 `sources`(또는 미리 만든 `descriptors`)를 전달해 문서에 포함할 HTTP 핸들러를 명시합니다.
+
+```typescript
+import { Controller, Get } from '@fluojs/http';
+import { Module } from '@fluojs/core';
+import { bootstrapNodeApplication } from '@fluojs/runtime/node';
+import { OpenApiModule, ApiOperation, ApiResponse, ApiTag } from '@fluojs/openapi';
+
+@ApiTag('Users')
+@Controller('/users')
+class UsersController {
+  @ApiOperation({ summary: '전체 사용자 목록 조회' })
+  @ApiResponse(200, { description: '성공' })
+  @Get('/')
+  list() {
+    return [];
+  }
+}
+
+@Module({
+  imports: [
+    OpenApiModule.forRoot({
+      sources: [{ controllerToken: UsersController }],
+      title: 'My API',
+      version: '1.0.0',
+      ui: true, // /docs에서 Swagger UI 활성화
+    })
+  ],
+  controllers: [UsersController]
+})
+class AppModule {}
+
+const app = await bootstrapNodeApplication(AppModule);
+await app.listen(3000);
+// OpenAPI JSON: http://localhost:3000/openapi.json
+// Swagger UI: http://localhost:3000/docs
+```
+
+컨트롤러 탐색을 직접 건너뛰고 싶다면 `descriptors: createHandlerMapping([...]).descriptors`를 대신 전달할 수 있습니다. `OpenApiModule`은 `@Module({ controllers: [...] })`만으로 핸들러를 자동 추론하지 않습니다.
+
+## 핵심 기능
+
+### 자동 명세 생성
+fluo는 컨트롤러와 메서드를 조사하여 전체 OpenAPI 3.1.0 문서를 작성합니다. 여기에는 경로, 메서드, 파라미터 및 요청 바디가 포함됩니다.
+
+### 통합 DTO 스키마
+`@fluojs/validation`과 원활하게 작동합니다. DTO 클래스는 자동으로 OpenAPI 컴포넌트로 변환되어 적절한 오퍼레이션에서 참조됩니다.
+
+### 버전 관리 지원
+`@fluojs/http`의 URI 기반 버전 관리를 자동으로 처리합니다. OpenAPI 경로에 해결된 버전 경로가 올바르게 반영됩니다.
+
+### 보안 문서화
+`@ApiBearerAuth()` 및 `@ApiSecurity()`를 사용하여 Bearer 토큰이나 API 키와 같은 보안 요구사항을 쉽게 문서화할 수 있습니다.
+
+### 결정적인 Swagger UI 자산
+`ui: true`를 활성화하면 생성되는 `/docs` 페이지는 정확한 `swagger-ui-dist` 버전의 자산을 참조하여 패키지 릴리스마다 동일한 동작을 유지합니다.
+
+## 공개 API
+
+- `OpenApiModule`: OpenAPI 통합을 위한 메인 엔트리 포인트.
+- `ApiTag`, `ApiOperation`, `ApiResponse`: 문서화 데코레이터.
+- `ApiBearerAuth`, `ApiSecurity`: 보안 요구사항 데코레이터.
+- `ApiExcludeEndpoint`: 특정 핸들러를 문서화에서 제외.
+- `buildOpenApiDocument`: 프로그래밍 방식의 문서 빌더 (저수준).
+
+## 관련 패키지
+
+- `@fluojs/core`: 공유 메타데이터 유틸리티.
+- `@fluojs/http`: 컨트롤러 및 라우팅 통합.
+- `@fluojs/validation`: DTO를 통한 스키마 및 모델 생성.
+
+## 예제 소스
+
+- `packages/openapi/src/openapi-module.test.ts`: 통합 테스트 및 사용 예제.
+- `examples/openapi-swagger`: 전체 OpenAPI 애플리케이션 예제.

package/README.md

@@ -0,0 +1,106 @@
+# @fluojs/openapi
+
+<p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
+
+Decorator-based OpenAPI 3.1.0 document generation for fluo. Automatically generate and serve your API documentation with zero manual synchronization and optional Swagger UI support.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [When to Use](#when-to-use)
+- [Quick Start](#quick-start)
+- [Core Capabilities](#core-capabilities)
+- [Public API](#public-api)
+- [Related Packages](#related-packages)
+- [Example Sources](#example-sources)
+
+## Installation
+
+```bash
+pnpm add @fluojs/openapi
+```
+
+## When to Use
+
+- When you want to provide interactive documentation for your REST API using **Swagger UI**.
+- When you need a machine-readable **OpenAPI 3.1.0** specification for client generation or testing.
+- When you want to keep your API documentation in sync with your code using standard decorators.
+- When you need to document complex request/response models using DTOs and validation metadata.
+
+## Quick Start
+
+Register the `OpenApiModule` and pass `sources` (or prebuilt `descriptors`) so the document builder knows which HTTP handlers to include.
+
+```typescript
+import { Controller, Get } from '@fluojs/http';
+import { Module } from '@fluojs/core';
+import { bootstrapNodeApplication } from '@fluojs/runtime/node';
+import { OpenApiModule, ApiOperation, ApiResponse, ApiTag } from '@fluojs/openapi';
+
+@ApiTag('Users')
+@Controller('/users')
+class UsersController {
+  @ApiOperation({ summary: 'List all users' })
+  @ApiResponse(200, { description: 'Success' })
+  @Get('/')
+  list() {
+    return [];
+  }
+}
+
+@Module({
+  imports: [
+    OpenApiModule.forRoot({
+      sources: [{ controllerToken: UsersController }],
+      title: 'My API',
+      version: '1.0.0',
+      ui: true, // Enable Swagger UI at /docs
+    })
+  ],
+  controllers: [UsersController]
+})
+class AppModule {}
+
+const app = await bootstrapNodeApplication(AppModule);
+await app.listen(3000);
+// OpenAPI JSON: http://localhost:3000/openapi.json
+// Swagger UI: http://localhost:3000/docs
+```
+
+If you need to bypass controller discovery, pass `descriptors: createHandlerMapping([...]).descriptors` instead. `OpenApiModule` does not infer handlers from `@Module({ controllers: [...] })` on its own.
+
+## Core Capabilities
+
+### Automated Specification Generation
+fluo inspects your controllers and methods to build a complete OpenAPI 3.1.0 document. This includes paths, methods, parameters, and request bodies.
+
+### Integrated DTO Schemas
+Works seamlessly with `@fluojs/validation`. Your DTO classes are automatically converted to OpenAPI components and referenced in the appropriate operations.
+
+### Versioning Support
+Handles URI-based versioning from `@fluojs/http` automatically. Your OpenAPI paths will correctly reflect the resolved versioned routes.
+
+### Security Documentation
+Easily document authentication requirements like Bearer tokens or API keys using `@ApiBearerAuth()` and `@ApiSecurity()`.
+
+### Deterministic Swagger UI Assets
+When `ui: true` is enabled, the generated `/docs` page references an exact `swagger-ui-dist` asset version so release behavior stays deterministic across package updates.
+
+## Public API
+
+- `OpenApiModule`: Main entry point for OpenAPI integration.
+- `ApiTag`, `ApiOperation`, `ApiResponse`: Documentation decorators.
+- `ApiBearerAuth`, `ApiSecurity`: Security requirement decorators.
+- `ApiExcludeEndpoint`: Omit specific handlers from documentation.
+- `buildOpenApiDocument`: Programmatic document builder (low-level).
+
+## Related Packages
+
+- `@fluojs/core`: Shared metadata utilities.
+- `@fluojs/http`: Controller and routing integration.
+- `@fluojs/validation`: Schema and model generation from DTOs.
+
+## Example Sources
+
+- `packages/openapi/src/openapi-module.test.ts`: Integration tests and usage examples.
+- `examples/openapi-swagger`: Complete OpenAPI application example.

package/dist/decorators.d.ts

@@ -0,0 +1,192 @@
+import { type Constructor, type MetadataPropertyKey } from '@fluojs/core';
+import type { OpenApiSchemaObject } from './schema-builder.js';
+/**
+ * User-facing operation metadata accepted by `@ApiOperation(...)`.
+ */
+export interface ApiOperationOptions {
+    summary?: string;
+    description?: string;
+    deprecated?: boolean;
+}
+/**
+ * User-facing response metadata accepted by `@ApiResponse(...)`.
+ */
+export interface ApiResponseOptions {
+    status: number;
+    description?: string;
+    schema?: OpenApiSchemaObject;
+    type?: Constructor;
+}
+/**
+ * User-facing parameter metadata accepted by `@ApiParam(...)`, `@ApiQuery(...)`, `@ApiHeader(...)`, and `@ApiCookie(...)`.
+ */
+export interface ApiParameterOptions {
+    description?: string;
+    required?: boolean;
+    schema?: OpenApiSchemaObject;
+}
+/**
+ * User-facing request-body metadata accepted by `@ApiBody(...)`.
+ */
+export interface ApiBodyOptions {
+    description?: string;
+    required?: boolean;
+    schema?: OpenApiSchemaObject;
+    content?: Record<string, {
+        schema: OpenApiSchemaObject;
+    }>;
+}
+/**
+ * Normalized operation metadata stored on controller methods.
+ */
+export interface ApiOperationMetadata {
+    summary?: string;
+    description?: string;
+    deprecated?: boolean;
+}
+/**
+ * Stored OpenAPI security requirement metadata for a single operation.
+ */
+export interface ApiSecurityRequirementMetadata {
+    [scheme: string]: string[];
+}
+/**
+ * Normalized response metadata stored on controller methods.
+ */
+export interface ApiResponseMetadata {
+    status: number;
+    description?: string;
+    schema?: OpenApiSchemaObject;
+    type?: Constructor;
+}
+/**
+ * Normalized parameter metadata stored on controller methods.
+ */
+export interface ApiParameterMetadata {
+    name: string;
+    in: 'cookie' | 'header' | 'path' | 'query';
+    description?: string;
+    required?: boolean;
+    schema?: OpenApiSchemaObject;
+}
+/**
+ * Normalized request-body metadata stored on controller methods.
+ */
+export interface ApiBodyMetadata {
+    description?: string;
+    required?: boolean;
+    schema?: OpenApiSchemaObject;
+    content?: Record<string, {
+        schema: OpenApiSchemaObject;
+    }>;
+}
+/**
+ * Aggregated OpenAPI metadata snapshot for a controller method.
+ */
+export interface MethodApiMetadata {
+    operation?: ApiOperationMetadata;
+    responses: ApiResponseMetadata[];
+    parameters?: ApiParameterMetadata[];
+    requestBody?: ApiBodyMetadata;
+    security?: string[];
+    securityRequirements?: ApiSecurityRequirementMetadata[];
+    excludeEndpoint?: boolean;
+}
+/**
+ * Read tags registered via `@ApiTag` on a controller class.
+ *
+ * @param target Controller class token.
+ * @returns A defensive copy of registered tags, or `undefined` when no tags are present.
+ */
+export declare function getControllerTags(target: Function): string[] | undefined;
+/**
+ * Read OpenAPI metadata registered for a controller method.
+ *
+ * @param target Controller class token.
+ * @param propertyKey Controller method key to inspect.
+ * @returns A defensive metadata snapshot, or `undefined` when the method has no OpenAPI metadata.
+ */
+export declare function getMethodApiMetadata(target: Function, propertyKey: MetadataPropertyKey): MethodApiMetadata | undefined;
+type ClassDecoratorFn = (value: Function, context: ClassDecoratorContext) => void;
+type MethodDecoratorFn = (value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Attach an OpenAPI tag to a controller class.
+ *
+ * Multiple tags can be declared by stacking `@ApiTag(...)` decorators.
+ *
+ * @param tag Tag label appended to the controller-level tag list.
+ * @returns A class decorator that stores controller tag metadata.
+ */
+export declare function ApiTag(tag: string): ClassDecoratorFn;
+/**
+ * Describe a controller method's OpenAPI operation metadata.
+ *
+ * @param options Operation metadata such as summary, description, and deprecation flag.
+ * @returns A method decorator that stores operation metadata.
+ */
+export declare function ApiOperation(options: ApiOperationOptions): MethodDecoratorFn;
+/**
+ * Exclude a controller method from generated OpenAPI `paths`.
+ *
+ * @returns A method decorator that marks the endpoint as excluded.
+ */
+export declare function ApiExcludeEndpoint(): MethodDecoratorFn;
+/**
+ * Add a security requirement to a controller method in the generated OpenAPI document.
+ *
+ * @param name Security scheme name (for example `bearerAuth`, `oauth2`, `apiKey`).
+ * @param scopes Optional OAuth scopes associated with this security requirement.
+ * @returns A method decorator that appends security metadata.
+ */
+export declare function ApiSecurity(name: string, scopes?: string[]): MethodDecoratorFn;
+/**
+ * Declare a path parameter for a controller method.
+ *
+ * @param name Parameter name.
+ * @param options Optional parameter metadata such as description, required, and schema.
+ * @returns A method decorator that appends path-parameter metadata.
+ */
+export declare function ApiParam(name: string, options?: ApiParameterOptions): MethodDecoratorFn;
+/**
+ * Declare a query parameter for a controller method.
+ *
+ * @param name Parameter name.
+ * @param options Optional parameter metadata such as description, required, and schema.
+ * @returns A method decorator that appends query-parameter metadata.
+ */
+export declare function ApiQuery(name: string, options?: ApiParameterOptions): MethodDecoratorFn;
+/**
+ * Declare a header parameter for a controller method.
+ *
+ * @param name Parameter name.
+ * @param options Optional parameter metadata such as description, required, and schema.
+ * @returns A method decorator that appends header-parameter metadata.
+ */
+export declare function ApiHeader(name: string, options?: ApiParameterOptions): MethodDecoratorFn;
+/**
+ * Declare a cookie parameter for a controller method.
+ *
+ * @param name Parameter name.
+ * @param options Optional parameter metadata such as description, required, and schema.
+ * @returns A method decorator that appends cookie-parameter metadata.
+ */
+export declare function ApiCookie(name: string, options?: ApiParameterOptions): MethodDecoratorFn;
+/**
+ * Declare an explicit request body for a controller method.
+ *
+ * @param options Request-body metadata and schema/content declarations.
+ * @returns A method decorator that stores request-body metadata.
+ */
+export declare function ApiBody(options: ApiBodyOptions): MethodDecoratorFn;
+/** Declare an expected HTTP response for a controller method. */
+export declare function ApiResponse(status: number, options?: Omit<ApiResponseOptions, 'status'>): MethodDecoratorFn;
+/** Declare an expected HTTP response for a controller method. */
+export declare function ApiResponse(options: ApiResponseOptions): MethodDecoratorFn;
+/**
+ * Mark a controller method as requiring Bearer token authentication in the OpenAPI spec.
+ *
+ * @returns A method decorator equivalent to `ApiSecurity('bearerAuth')`.
+ */
+export declare function ApiBearerAuth(): MethodDecoratorFn;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

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