entity-server-client 0.2.5 → 0.2.6

package/docs/apis.md

@@ -59,10 +59,10 @@ import { useEntityServer } from "entity-server-client/react";
 **admin-web 예시:**
 
 ```ts
-import { checkServerHealth, entityServer } from "entity-server-client";
+import { entityServer } from "entity-server-client";
 
 // 앱 초기화 시 한 번 실행 (예: App.tsx mount, main.tsx 초기화)
-const health = await checkServerHealth();
+const health = await entityServer.checkHealth();
 // → 서버의 packet_encryption: true 이면
 //   클라이언트의 encryptRequests: true 로 자동 설정됨
 ```
@@ -78,9 +78,8 @@ if (packet_encryption) {
 }
 ```
 
-> **중요:** `packetMagicLen` 값은 클라이언트가 미리 알고 있어야 합니다.
-> 빌드 시점에 `VITE_PACKET_MAGIC_LEN` 환경변수로 결정되며,
-> 서버와 일치해야 올바르게 복호화됩니다.
+> **주의:** 패킷 magic 길이(K)는 `K = 2 + key[31] % 14` 공식으로 패킷 키에서 자동 파생됩니다.
+> 클라이언트와 서버 모두 동일한 패킷 키를 보유하므로 별도 설정 필요 없습니다.
 
 ---
 
@@ -92,7 +91,6 @@ if (packet_encryption) {
 | ------------------ | ---------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `baseUrl`          | `string`                           | `VITE_ENTITY_SERVER_URL` 또는 `http://localhost:47200` | 서버 주소                                                                                                                                                                            |
 | `token`            | `string`                           | `""`                                                   | JWT Access Token                                                                                                                                                                     |
-| `packetMagicLen`   | `number`                           | `VITE_PACKET_MAGIC_LEN` 또는 `4`                       | 암호화 패킷 magic 바이트 길이                                                                                                                                                        |
 | `encryptRequests`  | `boolean`                          | `false`                                                | `true` 로 설정하면 인증된 POST/PUT/PATCH 요청 바디를 XChaCha20-Poly1305 로 암호화하여 전송합니다. 서버에서 `requirePacketEncryption = true` 로 설정된 경우 반드시 활성화해야 합니다. |
 | `keepSession`      | `boolean`                          | `false`                                                | `true`이면 `login()` 성공 후 Access Token 만료 전에 자동으로 갱신합니다.                                                                                                             |
 | `refreshBuffer`    | `number`                           | `60`                                                   | 만료 몇 초 전에 갱신을 시도할지 설정합니다. 예: `expires_in=3600`, `refreshBuffer=60` → 3540초 후 갱신                                                                               |
@@ -104,7 +102,6 @@ if (packet_encryption) {
 const client = new EntityServerClient({
     baseUrl: "https://api.example.com",
     token: "eyJhbGciOi...",
-    packetMagicLen: 4,
     encryptRequests: true, // 요청 바디 암호화 활성화
 });
 
@@ -120,17 +117,14 @@ import { entityServer } from "entity-server-client";
 client.configure({
     baseUrl: "https://api.example.com",
     token: "new-access-token",
-    packetMagicLen: 6,
     encryptRequests: true,
 });
 ```
 
-### `setToken(token)` / `setPacketMagicLen(length)` / `getPacketMagicLen()`
+### `setToken(token)`
 
 ```ts
 client.setToken("eyJhbGciOi...");
-client.setPacketMagicLen(4);
-const len = client.getPacketMagicLen(); // 4
 ```
 
 ---
@@ -658,7 +652,6 @@ import { useEntityServer } from "entity-server-client/react";
 | ------------------ | ----------------------------------- | ------ | ----------------------------------------------------------------------------------------------- |
 | `singleton`        | `boolean`                           | `true` | `true`이면 전역 `entityServer` 인스턴스 사용                                                    |
 | `baseUrl`          | `string`                            | —      | 서버 주소 (singleton일 때 `configure()` 호출)                                                   |
-| `packetMagicLen`   | `number`                            | —      | 암호화 패킷 magic 바이트 길이                                                                   |
 | `token`            | `string`                            | —      | JWT Access Token                                                                                |
 | `tokenResolver`    | `() => string \| undefined \| null` | —      | 렌더 시점에 토큰을 동적으로 주입하는 함수                                                       |
 | `keepSession`      | `boolean`                           | —      | 세션 유지 활성화 (인덱스 참고)                                                                  |

package/docs/react.md

@@ -12,7 +12,7 @@ import { useEntityServer } from "entity-server-client/react";
 import { useEntityServer } from "entity-server-client/react";
 
 export function AccountPage() {
-  const client = useEntityServer({
+  const { client } = useEntityServer({
     tokenResolver: () => localStorage.getItem("auth_access_token"),
   });
 
@@ -34,7 +34,7 @@ export function AccountPage() {
 - `false`: 훅 호출 스코프마다 새 인스턴스 생성
 
 ```ts
-const client = useEntityServer({
+const { client } = useEntityServer({
     singleton: false,
     baseUrl: "http://localhost:47200",
 });
@@ -45,19 +45,18 @@ const client = useEntityServer({
 렌더 시점에 토큰을 읽어 자동으로 `setToken`을 적용합니다.
 
 ```ts
-const client = useEntityServer({
+const { client } = useEntityServer({
     tokenResolver: () => sessionStorage.getItem("access_token"),
 });
 ```
 
-### `baseUrl`, `token`, `packetMagicLen`
+### `baseUrl`, `token`
 
 `EntityServerClientOptions`와 동일하게 전달할 수 있습니다.
 
 ```ts
-const client = useEntityServer({
+const { client } = useEntityServer({
     baseUrl: import.meta.env.VITE_ENTITY_SERVER_URL,
-    packetMagicLen: Number(import.meta.env.VITE_PACKET_MAGIC_LEN ?? 4),
 });
 ```
 
@@ -68,7 +67,7 @@ import { useQuery } from "@tanstack/react-query";
 import { useEntityServer } from "entity-server-client/react";
 
 export function useAccountList() {
-    const client = useEntityServer({
+    const { client } = useEntityServer({
         tokenResolver: () => localStorage.getItem("auth_access_token"),
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "entity-server-client",
-    "version": "0.2.5",
+    "version": "0.2.6",
     "license": "MIT",
     "type": "module",
     "publishConfig": {
@@ -30,6 +30,7 @@
         "@noble/hashes": "^1.7.2"
     },
     "devDependencies": {
+        "@types/node": "^25.3.3",
         "@types/react": "^19.2.2",
         "esbuild": "^0.25.0",
         "react": "^19.2.0",