安装

Core 是框架无关的，只有在使用 Next.js 和 RSocket 功能时才导入单独的入口点。

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 流、HeaderStore、会话认证和 CSR 缓存包含在基本入口中。即使不使用 Next.js 也可以使用 Core。

Next.js 适配器（可选）

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

仅在需要时导入

/next是为 Next.js App Router 提供的功能。在不使用 Next.js 的项目中不导入。

RSocket 适配器（可选）

仅在使用 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 也是可选功能

在不使用 RSocket 的项目中，不导入 @byeolnaerim/typed-rx-http/rsocket，也不安装对等包。

OpenAPI/Swagger 自动节点脚本（可选）

除了运行时 HTTP 客户端外，还包括从 OpenAPI/Swagger JSON 生成 TypeScript 类型和服务文件的 Node 脚本。此功能是可选的，不需要 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。不使用生成器的项目不受 openapi-typescript 或 TypeScript 5.9.3 的限制。