Generator API

브라우저 runtime과 분리된 Node-only OpenAPI·AsyncAPI 생성기입니다.

connectToSwaggerEventStream

SSE watcher를 시작하고 close() handle을 반환합니다.

generateSwaggerFromHttp

plain JSON GET one-shot 생성.

generateSwaggerFromFile

local file one-shot 생성.

requestJsonOnce

옵션에 맞춰 HTTP(S) JSON을 한 번 가져옵니다.

handleSwaggerData

받은 Swagger object를 저장하고 types, union arrays, services 생성 단계로 전달합니다.

generateTypes

openapi-typescript process를 실행합니다.

generateUnionArrays

enum/union 후보를 apiUnionArrays.ts로 생성합니다.

generateSwaggerServices

paths에서 서비스와 schema alias 파일을 생성합니다.

Name	Type	Default	Description
hostname	string	localhost	backend host.
port	number	8123	backend port.
path	string	/for-local/get-swagger	Swagger endpoint.
serviceDir	string	./src/handler/service	서비스 출력 폴더.
swaggerFile	string	./swagger.json	원본 JSON 저장 경로.
typesDir	string	./src/handler/service/@types	서비스별 타입 출력 폴더.
typesFile	string	./src/handler/service/@types/ApiTypes.d.ts	openapi-typescript 출력 파일.
unionArraysFile	string	./src/handler/service/apiUnionArrays.ts	union array 출력 파일.
commonServiceFile	string	./src/handler/service/commonService.ts	생성 서비스가 callApi를 import할 사용자 소유 파일.
reconnectDelayMs	number	10000	watcher 재접속 지연.
generateServices	boolean	true	서비스 생성 여부.
generateUnionArraysFile	boolean	true	union array 생성 여부.
keepAlive	boolean	true	CLI watcher process 유지 timer.

connectToAsyncApiRSocketEventStream

AsyncAPI SSE watcher.

generateAsyncApiRSocketFromHttp

plain JSON GET one-shot 생성.

generateAsyncApiRSocketFromFile

local AsyncAPI file one-shot 생성.

generateAsyncApiTypes

schemas와 channels를 TypeScript source 문자열로 변환합니다.

writeAsyncApiTypes

AsyncAPI type file을 write-if-changed 방식으로 저장합니다.

generateAsyncApiRSocketServices

controller/destination별 RSocket 서비스와 request/response alias를 생성합니다.

Name	Type	Default	Description
hostname	string	localhost	backend host.
port	number	8123	backend port.
path	string	/for-local/get-asyncapi-rsocket	AsyncAPI endpoint.
serviceDir	string	./src/handler/service	RSocket 서비스 출력 폴더.
asyncApiRSocketFile	string	./asyncapi-rsocket.json	원본 JSON 저장 경로.
typesDir	string	./src/handler/service/@types	서비스별 타입 출력 폴더.
typesFile	string	./src/handler/service/@types/AsyncApiTypes.ts	통합 AsyncAPI 타입 파일.
commonRSocketServiceFile	string	./src/handler/service/rsoketCommonService.ts	생성 서비스가 mono/stream 함수를 import할 사용자 소유 파일.
reconnectDelayMs	number	10000	watcher 재접속 지연.
generateServices	boolean	true	서비스 생성 여부.
keepAlive	boolean	true	CLI watcher process 유지 timer.

json

기본 모드

옵션이 없으면 EventStream watcher, --http는 one-shot HTTP,--file은 기본 로컬 JSON 파일 모드입니다.