Installation

Core는 framework-agnostic이고, Next.js와 RSocket 기능은 사용하는 경우에만 별도 엔트리포인트를 import합니다.

npm 설치

bash

npm i @byeolnaerim/typed-rx-http rxjs

Core (프레임워크 독립)

import {
  createHttpClient,
  createHeaderStore,
  createCsrCache,
  createSessionAuth,
  HttpResponseError,
  isHttpResponseError,
  type ServiceArguments,
  type CacheForService,
} from "@byeolnaerim/typed-rx-http";

일반 HTTP 요청, NDJSON streaming, HeaderStore, session auth와 CSR cache는 기본 엔트리포인트에 포함됩니다. Next.js를 사용하지 않아도 Core를 사용할 수 있습니다.

Next.js 어댑터 (선택)

import {
  callApiSsrCache,
  redirectToUnauthorizedOnServer401,
} from "@byeolnaerim/typed-rx-http/next";

필요할 때만 import

/next는 Next.js App Router용 기능입니다. Next.js를 사용하지 않는 프로젝트에서는 import하지 않습니다.

RSocket 어댑터 (선택)

RSocket을 사용하는 프로젝트에서만 peer 패키지를 설치합니다.

bash

npm i rsocket-core rsocket-types rsocket-websocket-client

import { createRSocketApi } from "@byeolnaerim/typed-rx-http/rsocket";

const api = createRSocketApi("ws://localhost:7000/rsocket", jwt);

api.mono<User>("user.findById", { id: 1 }).subscribe((user) => {
  console.log(user);
});

api.stream<Notification>("notification.stream").subscribe((notification) => {
  console.log(notification);
});

RSocket도 선택 기능

RSocket을 사용하지 않는 프로젝트에서는 @byeolnaerim/typed-rx-http/rsocket을 import하지 않고 peer 패키지도 설치하지 않습니다.

OpenAPI/Swagger Auto Node Script (선택)

런타임 HTTP client와 별도로 OpenAPI/Swagger JSON에서 TypeScript 타입과 service 파일을 생성하는 Node script도 포함되어 있습니다. 이 기능은 선택 사항이며 Core, /next, /rsocket 사용에 필요하지 않습니다.

import {
  connectToSwaggerEventStream,
  generateSwaggerFromHttp,
  generateSwaggerFromFile,
} from "@byeolnaerim/typed-rx-http/auto-node-script/openapi";

openapi-typescript도 일반 설치에 필요하지 않음

OpenAPI 생성 단계에서만 별도의 npx 실행 환경으로 openapi-typescript와 TypeScript 5.9.3을 사용합니다. generator를 사용하지 않는 프로젝트는 openapi-typescript나 TypeScript 5.9.3에 묶이지 않습니다.