Instalación

Core es agnóstico al framework, y las funcionalidades de Next.js y RSocket solo importan un punto de entrada separado si se utilizan.

Instalación de npm

bash

npm i @byeolnaerim/typed-rx-http rxjs

Core (independiente del framework)

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

Las solicitudes HTTP generales, streaming NDJSON, HeaderStore, autenticación de sesión y caché CSR están incluidas en el punto de entrada básico. Se puede usar Core sin Next.js.

Adaptador de Next.js (opcional)

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

Importar solo cuando sea necesario

/nextes una funcionalidad para Next.js App Router. No se importa en proyectos que no utilizan Next.js.

Adaptador de RSocket (opcional)

Solo se instalan paquetes peer en proyectos que utilizan 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 también es una funcionalidad opcional.

En proyectos que no utilizan RSocket, no se importa @byeolnaerim/typed-rx-http/rsocket ni se instalan paquetes peer.

Script de Node Auto OpenAPI/Swagger (opcional)

Además del cliente HTTP en tiempo de ejecución, también se incluye un script de Node que genera tipos de TypeScript y archivos de servicio desde JSON de OpenAPI/Swagger. Esta funcionalidad es opcional y no es necesaria para usar Core, /next, /rsocket.

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

openapi-typescript tampoco es necesario para la instalación general.

Solo se utiliza openapi-typescript y TypeScript 5.9.3 en un entorno de ejecución npx separado durante la etapa de generación de OpenAPI. Los proyectos que no utilizan el generador no están atados a openapi-typescript ni a TypeScript 5.9.3.