@vibexnpm/talkx 7.3.0 → 8.1.0

package/README.md

@@ -2,6 +2,8 @@
 
 채팅 + WebRTC + 웹 푸시 통합 JavaScript SDK.
 
+로그인·새로고침 복구·FE 인증 상태 연동은 [Refresh 세션 가이드](docs/REFRESH_AUTH.md)를 따릅니다. 새 서버의 refresh API가 필요합니다.
+
 ```bash
 npm install @vibexnpm/talkflow
 ```

package/dist/index.d.ts

@@ -1036,8 +1036,14 @@ export interface LoginMember {
  * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가 함께 정해진다.
  */
 export interface LoginResult {
+    /** SDK가 저장·회전하는 갱신 자격. 직접 API를 쓰는 경우에만 응답에서 사용한다. */
+    refreshToken?: string;
+    /** 서버 현재 시각 및 refresh 만료 시각, Unix epoch 밀리초. */
+    serverTime?: number;
+    refreshExpiresAt?: number;
     accessToken: string;
     tokenType: string;
+    /** Access 만료 시각, Unix epoch 초(남은 시간 아님). */
     expiresIn?: number;
     projectId: string;
     /** 회사의 활성 ck- 키. SDK 초기화의 `apiKey` 로 그대로 넣는다. */
@@ -1464,11 +1470,16 @@ export interface AssistantProgressSnapshot extends AssistantRoomProgressEvent {
 // Options — constructor & method
 // ============================================================================
 
+export type AuthState = 'checking' | 'authenticated' | 'unauthenticated' | 'unavailable';
+export interface AccessTokenOptions { forceRefresh?: boolean; rejectedToken?: string; }
+
 export interface TalkFlowClientOptions {
     /** Client API 키 (브라우저 노출 안전). */
-    apiKey: string;
+    apiKey?: string;
     /** 프로젝트 ID. */
-    projectId: string;
+    projectId?: string;
+    /** refresh: 키 없이 생성 후 restoreSession/loginUser 가능. 기존 JWT만 쓰면 legacy. */
+    sessionMode?: 'refresh' | 'legacy';
     /** JWT 토큰 — 고객사 backend 에서 발급 받아 전달. */
     jwtToken?: string;
     /** 환경. 기본 'production'. */
@@ -1867,6 +1878,8 @@ export interface TalkFlowClientEvents {
     connectionError: unknown;
     tokenSet: { userId: string };
     loggedOut: void;
+    authStateChanged: { state: AuthState; previous: AuthState; error?: unknown };
+    authError: unknown;
 
     // Chat (re-emit from ChatClient with prefixed names)
     chatMessage: ChatMessageReceivedPayload;
@@ -2432,6 +2445,18 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     /** 회원 로그인 (인스턴스) — 재로그인·계정 전환용. 성공 시 토큰을 자동 설정한다. */
     loginUser(credentials: { email: string; password: string }): Promise<LoginResult>;
 
+    /** localStorage의 refresh로 복구. 세션이 없으면 null, 네트워크/서버 장애는 reject. */
+    static restoreSession(options: { serverUrl: string }): Promise<LoginResult | null>;
+    restoreSession(): Promise<LoginResult | null>;
+    /** 캐시된 UI 상태. 호출 자체는 통신하지 않으며 서버 권한 판정은 요청 시 수행된다. */
+    getAuthState(): AuthState;
+    isLoggedIn(): boolean;
+    /** 유효한 메모리 토큰 반환. 필요할 때만 갱신하며 동시 요청은 하나로 합친다. */
+    getAccessToken(options?: AccessTokenOptions): Promise<string>;
+    /** 관리/캘린더 등 SDK 밖 호출용. 토큰 준비와 인증 오류 1회 재시도를 공통 적용한다. */
+    request<T = unknown>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', path: string,
+        options?: { body?: unknown; params?: Record<string, unknown>; headers?: Record<string, string> }): Promise<T>;
+
     /** 내 정보 조회. */
     getMyProfile(): Promise<MyProfile>;
 
@@ -2448,7 +2473,7 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
         timeZone?: string;
     }): Promise<MyProfile>;
 
-    /** 비밀번호 변경 — 현재 비밀번호 재확인. 토큰은 그대로 유효해 재로그인이 필요 없다. */
+    /** 비밀번호 변경 — 기존 세션을 모두 폐기하고 이 브라우저에 새 세션을 자동 채택한다. */
     changeMyPassword(params: { currentPassword: string; newPassword: string }): Promise<unknown>;
 
     // Connection lifecycle