Instalação

O Core é agnóstico em relação ao framework, e as funcionalidades do Next.js e RSocket são importadas apenas se utilizadas.

Instalação npm

bash

npm i @byeolnaerim/typed-rx-http rxjs

Core (independente de framework)

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

Requisições HTTP comuns, streaming NDJSON, HeaderStore, autenticação de sessão e cache CSR estão incluídos no ponto de entrada padrão. O Core pode ser usado mesmo sem o Next.js.

Adaptador Next.js (opcional)

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

Importar apenas quando necessário

/nexté uma funcionalidade para o Next.js App Router. Não deve ser importado em projetos que não utilizam Next.js.

Adaptador RSocket (opcional)

Instale pacotes peer apenas em projetos que utilizam 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 também é uma funcionalidade opcional

Em projetos que não utilizam RSocket, não importe @byeolnaerim/typed-rx-http/rsocket e não instale pacotes peer.

Script Node Auto OpenAPI/Swagger (opcional)

Além do cliente HTTP em tempo de execução, também inclui um script Node que gera tipos TypeScript e arquivos de serviço a partir de JSON OpenAPI/Swagger. Esta funcionalidade é opcional e não é necessária para o uso do Core, /next, /rsocket.

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

openapi-typescript também não é necessário para instalação padrão

O openapi-typescript e TypeScript 5.9.3 são usados apenas em um ambiente de execução npx separado durante a geração OpenAPI. Projetos que não utilizam o gerador não estão vinculados ao openapi-typescript ou TypeScript 5.9.3.