connectbase-client 1.9.0 → 1.9.1

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [1.9.1] - 2026-04-25
+
+문서 정합성 패치. 런타임 동작은 1.9.0 과 동일합니다.
+
+### Fixed — `ConnectBaseConfig.persistence` jsdoc 모순
+
+- `src/index.ts` 의 `persistence?: TokenPersistence` jsdoc 이 `@default 'localStorage'` 로 표기되어 있었지만, 실제 `HttpClient` 동작은 `?? 'none'` (메모리 저장) 으로 fallback (`src/core/http.ts:104-107`). 같은 패키지 내 [src/core/http.ts:21-29](src/core/http.ts) 의 doc-comment 는 `'none' (권장·기본값)` 으로 올바르게 표기되어 있었음.
+- IDE/타입 hint 가 잘못된 정보를 안내해 사용자가 새로고침 시 로그아웃되는 동작을 "버그" 로 오인할 수 있었음.
+- 두 doc-comment 를 일치시켜 `@default 'none'` 으로 정정. 보안·XSS 메모도 함께 명시.
+- **Behavior change 없음** — 기본 동작은 1.6.0 이후 줄곧 `'none'` 이었습니다.
+
 ## [1.9.0] - 2026-04-24
 
 런타임 내구성·관측성 강화 릴리스. 공개 API 시그니처는 유지되며 모든 변경은 추가·하드닝 성격(비파괴).

package/dist/index.d.mts

@@ -6714,10 +6714,10 @@ interface ConnectBaseConfig {
     onTokenExpired?: () => void;
     /**
      * 토큰 저장 방식.
-     * - 'localStorage': 브라우저 종료 후에도 유지 (기본값)
-     * - 'sessionStorage': 탭 종료 시 삭제
-     * - 'none': 메모리에만 저장 (페이지 새로고침 시 삭제)
-     * @default 'localStorage'
+     * - 'none' (기본·권장): 메모리에만 저장. 새로고침 시 재로그인 필요. XSS 노출 최소화
+     * - 'sessionStorage': 탭 종료 시 삭제 (XSS 시 현재 탭 세션 탈취 가능)
+     * - 'localStorage': 브라우저 종료 후에도 유지 (XSS 시 토큰 영구 탈취 가능 — 콘솔 경고 출력)
+     * @default 'none'
      */
     persistence?: TokenPersistence;
     /**

package/dist/index.d.ts

@@ -6714,10 +6714,10 @@ interface ConnectBaseConfig {
     onTokenExpired?: () => void;
     /**
      * 토큰 저장 방식.
-     * - 'localStorage': 브라우저 종료 후에도 유지 (기본값)
-     * - 'sessionStorage': 탭 종료 시 삭제
-     * - 'none': 메모리에만 저장 (페이지 새로고침 시 삭제)
-     * @default 'localStorage'
+     * - 'none' (기본·권장): 메모리에만 저장. 새로고침 시 재로그인 필요. XSS 노출 최소화
+     * - 'sessionStorage': 탭 종료 시 삭제 (XSS 시 현재 탭 세션 탈취 가능)
+     * - 'localStorage': 브라우저 종료 후에도 유지 (XSS 시 토큰 영구 탈취 가능 — 콘솔 경고 출력)
+     * @default 'none'
      */
     persistence?: TokenPersistence;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",