Installation

Core is framework-agnostic. Import the separate Next.js and RSocket entry points only when you use those features.

npm install

bash

npm i @byeolnaerim/typed-rx-http rxjs

Core (framework-independent)

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

Standard HTTP requests, NDJSON streaming, HeaderStore, session auth, and CSR cache are included in the default entry point. Core can be used without Next.js.

Next.js adapter (optional)

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

Import only when needed

/nextis for the Next.js App Router. Do not import it in projects that do not use Next.js.

RSocket adapter (optional)

Install the peer packages only in projects that use RSocket.

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 is also optional

In projects that do not use RSocket, do not import @byeolnaerim/typed-rx-http/rsocket and do not install its peer packages.

OpenAPI/Swagger Auto Node Script (optional)

In addition to the runtime HTTP client, the package includes a Node script that generates TypeScript types and service files from OpenAPI/Swagger JSON. This feature is optional and is not required to use Core, /next, or /rsocket.

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

openapi-typescript is not required for a normal installation either

openapi-typescript and TypeScript 5.9.3 are used only in a separate npx execution environment during OpenAPI generation. Projects that do not use the generator are not tied to openapi-typescript or TypeScript 5.9.3.