Instalasi

Core bersifat framework-agnostic, dan fitur Next.js serta RSocket hanya diimpor jika digunakan.

Instal npm

bash

npm i @byeolnaerim/typed-rx-http rxjs

Core (independen framework)

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

Permintaan HTTP umum, streaming NDJSON, HeaderStore, otentikasi sesi, dan cache CSR termasuk dalam entri utama. Core dapat digunakan tanpa Next.js.

Adaptor Next.js (opsional)

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

import hanya saat diperlukan

/nextadalah fitur untuk Next.js App Router. Tidak diimpor di proyek yang tidak menggunakan Next.js.

Adaptor RSocket (opsional)

Hanya proyek yang menggunakan RSocket yang perlu menginstal paket 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 juga merupakan fitur opsional

Di proyek yang tidak menggunakan RSocket, tidak mengimpor @byeolnaerim/typed-rx-http/rsocket dan tidak menginstal paket peer.

OpenAPI/Swagger Auto Node Script (opsional)

Selain klien HTTP runtime, juga mencakup skrip Node yang menghasilkan tipe TypeScript dan file service dari OpenAPI/Swagger JSON. Fitur ini bersifat opsional dan tidak diperlukan untuk penggunaan Core, /next, /rsocket.

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

openapi-typescript juga tidak diperlukan untuk instalasi umum

Hanya menggunakan openapi-typescript dan TypeScript 5.9.3 dalam lingkungan eksekusi npx terpisah selama tahap pembuatan OpenAPI. Proyek yang tidak menggunakan generator tidak terikat pada openapi-typescript atau TypeScript 5.9.3.