@vibexnpm/talkx 5.4.0 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "5.4.0",
+    "version": "6.1.0",
     "type": "module",
     "description": "TalkFlow SDK - Chat & WebRTC unified client",
     "main": "dist/talkflow-sdk.umd.js",

package/src/TalkFlowClient.js

@@ -35,15 +35,11 @@ class TalkFlowClient extends EventEmitter {
      * @param {number} [options.logLevel=LogLevel.WARN] - 로그 레벨
      *
      * @example
-     * // 1단계: 고객사 backend 가 talkflow JWT 를 발급받음 (Server API Key 사용)
-     * //   POST https://chat.apiorbit.net/api/v1/users/auth
-     * //   Headers: X-API-KEY: <SERVER_KEY>, X-PROJECT-ID: <project-id>
-     * //   Body: { userId: 'user-123', nickname: '홍길동' }
-     * //   Response: { accessToken, refreshToken }
+     * // 1단계: 로그인 — 클라이언트 생성 «전» 에 부른다. ck/projectId/JWT 를 한 번에 받는다.
+     * //   const { clientKey, projectId, accessToken } = await TalkFlowClient.loginUser({
+     * //       serverUrl, email, password });
      *
-     * // 2단계: 고객사 backend 가 최종 사용자 브라우저에 JWT 전달 (자사 API 응답 등)
-     *
-     * // 3단계: 브라우저에서 SDK 초기화
+     * // 2단계: 받은 값으로 SDK 초기화
      * const client = new TalkFlowClient({
      *     apiKey: 'CLIENT_KEY',          // 브라우저에 노출되는 Client Key
      *     projectId: 'your-project-id',
@@ -174,24 +170,13 @@ class TalkFlowClient extends EventEmitter {
             throw new Error('projectId is required');
         }
 
-        // Server Key (sk-) 브라우저 사용 경고
-        // - development: 경고만 (registerUser 빠른 테스트 허용)
-        // - staging/production: 경고 + 강력 안내
+        // Server Key (sk-) 는 SDK 가 쓸 일이 없다 — 유일한 용도였던 registerUser(/users/auth) 가
+        // 사라졌다. 그래도 들어오면 잘못된 키를 넣은 것이므로 알린다.
         if (options.apiKey.startsWith('sk-')) {
-            const env = options.env || 'production';
-            if (env === 'development') {
-                console.warn(
-                    '⚠️ [TalkFlow] Server Key (sk-) 를 개발 모드에서 사용 중입니다. ' +
-                    '프로덕션 배포 전에 반드시 Client Key (ck-) 로 교체하세요.'
-                );
-            } else {
-                console.error(
-                    '🚨 [TalkFlow] Server Key (sk-) 가 비개발 환경 (' + env + ') 에서 감지되었습니다. ' +
-                    '보안 위험: Server Key 를 브라우저에 포함하면 공격자가 임의 사용자로 JWT 를 발급받을 수 있습니다. ' +
-                    '반드시 Client Key (ck-) 로 교체하세요. ' +
-                    '서버에서도 프로덕션 모드에서 Server Key 의 브라우저 호출을 차단합니다.'
-                );
-            }
+            console.error(
+                '🚨 [TalkFlow] Server Key (sk-) 로 SDK 를 초기화했습니다. ' +
+                'SDK 는 Client Key (ck-) 만 사용합니다 — loginUser() 응답의 clientKey 를 그대로 쓰세요.'
+            );
         }
     }
 
@@ -238,57 +223,123 @@ class TalkFlowClient extends EventEmitter {
     // ==================== 사용자 API ====================
 
     /**
-     * 사용자 인증 (등록/로그인).
-     * 인증 성공 시 반환된 JWT 토큰을 자동으로 설정합니다.
+     * 회원 로그인 — 이메일/비밀번호로 채팅 접속 일체를 받는다. **클라이언트 생성 전에 호출한다.**
      *
-     * <h3>⚠️ Server API Key 전용</h3>
-     * <p>이 메서드는 JWT 를 발급하는 엔드포인트 ({@code POST /api/v1/users/auth}) 를 호출합니다.
-     * <strong>프로덕션 환경에서는 Client API Key 로 이 메서드를 호출하면 서버가 403 을 반환합니다.</strong></p>
+     * <p>Server Key 도 고객사 BFF 도 필요 없다. 응답의
+     * {@code clientKey}/{@code projectId}/{@code accessToken} 이 그대로 SDK 초기화 입력이다.</p>
      *
-     * <ul>
-     *   <li><strong>개발/프로토타입</strong>: Server Key 로 SDK 를 초기화한 뒤 이 메서드를 사용하면 빠르게 테스트 가능</li>
-     *   <li><strong>프로덕션</strong>: 고객사 backend 에서 Server Key 로 직접 {@code POST /api/v1/users/auth} 를 호출 →
-     *       JWT 를 받아 SDK 에 {@code setToken(jwt)} 으로 전달. 이 메서드를 브라우저에서 쓰지 마세요.</li>
-     * </ul>
+     * <p><b>회사 선택 단계가 없다</b>: 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가
+     * 함께 정해진다. 퇴사하면 그 키가 풀려 다른 회사에서 같은 이메일을 다시 쓸 수 있다.</p>
      *
-     * <p>자세한 내용은 README 의 "프로덕션 인증 플로우" 섹션 참고.</p>
-     *
-     * @param {Object} userData
-     * @param {string} userData.userId - 사용자 ID (필수, 고객사 회원 ID)
-     * @param {string} userData.nickname - 닉네임 (필수, max 100자)
-     * @param {string} [userData.profileImageUrl] - 프로필 이미지 URL (max 500자)
-     * @param {Object} [userData.metadata] - 추가 메타데이터
-     * @returns {Promise<Object>} 인증 결과 (토큰 포함)
+     * @param {Object} options
+     * @param {string} options.serverUrl - 채팅 서버 base URL
+     * @param {string} options.email
+     * @param {string} options.password
+     * @returns {Promise<Object>} `{accessToken, tokenType, expiresIn, projectId, clientKey, user}`
      *
      * @example
-     * // 개발 환경 — Server Key 로 빠른 테스트
+     * const login = await TalkFlowClient.loginUser({
+     *     serverUrl: 'https://chat.apiorbit.net',
+     *     email: 'dan@example.com',
+     *     password: '********'
+     * });
+     *
      * const client = new TalkFlowClient({
-     *     apiKey: 'SERVER_KEY',
-     *     projectId: 'your-project-id',
-     *     env: 'development'
+     *     apiKey: login.clientKey,
+     *     projectId: login.projectId,
+     *     jwtToken: login.accessToken
      * });
-     * await client.registerUser({ userId: 'user-123', nickname: '홍길동' });
      * await client.connect();
      */
-    async registerUser(userData) {
-        // 다국어: navigator.language 자동 시드 — 호출자가 preferredLanguage 를 명시하지 않은 경우에만.
-        // 서버 /users/auth 는 seed-if-absent (기존 값 비클로버) 라 매 인증마다 덮어쓰지 않아 안전.
-        const payload = { ...userData };
-        if (payload.preferredLanguage === undefined) {
-            const detected = TalkFlowClient.detectBrowserLanguage();
-            if (detected) {
-                payload.preferredLanguage = detected;
-            }
+    static async loginUser({ serverUrl, email, password }) {
+        if (!serverUrl) throw new Error('serverUrl is required');
+        if (!email) throw new Error('email is required');
+        if (!password) throw new Error('password is required');
+
+        // 로그인은 키를 «받기 위해» 부르는 경로라 X-API-KEY/X-PROJECT-ID 가 없다(서버에서 필터 제외).
+        const client = new ApiClient({ baseUrl: serverUrl, apiKey: '', projectId: '' });
+        const response = await client.post('/api/v1/auth/login', { email, password });
+        return (response && response.data) ? response.data : response;
+    }
+
+    /**
+     * 회원 로그인 (인스턴스) — 성공 시 JWT 를 자동 설정한다.
+     *
+     * <p>이미 클라이언트가 있는 상태의 재로그인·계정 전환용이다. 최초 진입은 클라이언트 생성 전에
+     * 부르는 정적 {@link TalkFlowClient.loginUser} 를 쓴다 — 그쪽이 {@code clientKey} 까지 준다.</p>
+     *
+     * @param {Object} credentials
+     * @param {string} credentials.email
+     * @param {string} credentials.password
+     * @returns {Promise<Object>} 로그인 응답
+     */
+    async loginUser({ email, password }) {
+        const response = await this.apiClient.post('/api/v1/auth/login', { email, password });
+        const data = (response && response.data) ? response.data : response;
+
+        if (data && data.accessToken) {
+            await this.setToken(data.accessToken);
+            this.logger.info('Member logged in, token auto-set');
         }
+        return data;
+    }
 
-        const response = await this.apiClient.post('/api/v1/users/auth', payload);
+    /**
+     * 내 정보 조회.
+     *
+     * @returns {Promise<Object>} `{userId, email, name, phone, profileUrl, companyRole, orgNodeId, orgName, ...}`
+     */
+    async getMyProfile() {
+        this._checkToken();
+        const response = await this.apiClient.get('/api/v1/me');
+        return (response && response.data) ? response.data : response;
+    }
 
-        if (response.data && response.data.accessToken) {
-            await this.setToken(response.data.accessToken);
-            this.logger.info('User authenticated, token auto-set');
+    /**
+     * 내 정보 수정 — 이름·전화번호·프로필 이미지.
+     *
+     * <p>서버가 <b>새 JWT</b> 를 함께 준다: {@code name}/{@code profileUrl} 이 토큰 claim 이라
+     * 갱신하지 않으면 옛 값이 토큰 만료(7일)까지 계속 나간다. 여기서 자동 채택한다.</p>
+     *
+     * <p>이메일·조직·역할은 바꿀 수 없다 — 이메일은 로그인 키, 조직은 파트너가 정하고,
+     * 역할은 본인이 승급할 수 없어야 한다.</p>
+     *
+     * @param {Object} profile
+     * @param {string} [profile.name]
+     * @param {string} [profile.phone]
+     * @param {string} [profile.profileUrl]
+     * @returns {Promise<Object>} 갱신된 내 정보 (accessToken 포함)
+     */
+    async updateMyProfile(profile) {
+        this._checkToken();
+        const response = await this.apiClient.put('/api/v1/me', profile);
+        const data = (response && response.data) ? response.data : response;
+
+        if (data && data.accessToken) {
+            // 토큰 교체 실패로 수정 자체를 실패시키지 않는다 — 서버 반영은 이미 끝났고 옛 토큰도
+            // 유효(낡았을 뿐)하므로 여기서 throw 하면 호출자가 이미 적용된 수정을 다시 시도한다.
+            try {
+                await this.setToken(data.accessToken);
+            } catch (error) {
+                this.logger.warn('Profile updated but token refresh failed; keeping the old token', error);
+            }
         }
+        return data;
+    }
 
-        return response;
+    /**
+     * 비밀번호 변경 — 현재 비밀번호를 재확인한다.
+     *
+     * <p>토큰만 탈취해도 비밀번호를 바꿀 수 있으면 계정을 통째로 빼앗긴다. 비밀번호는 바뀌어도
+     * 토큰은 그대로 유효하다 — 재로그인이 필요하지 않다.</p>
+     *
+     * @param {Object} params
+     * @param {string} params.currentPassword
+     * @param {string} params.newPassword - 8자 이상
+     */
+    async changeMyPassword({ currentPassword, newPassword }) {
+        this._checkToken();
+        return this.apiClient.put('/api/v1/me/password', { currentPassword, newPassword });
     }
 
     /**
@@ -344,7 +395,9 @@ class TalkFlowClient extends EventEmitter {
      * 지역 변형을 그대로 보내면 명시 요청({@code lang: 'en'})과 키가 분열되어 같은 언어 이중 생성·조회 miss 가
      * 발생한다. 서버 {@code LanguageCode} 도 동일 규칙으로 축약하므로 어느 쪽으로 들어와도 같은 값이 된다.</p>
      *
-     * <p>{@link #registerUser} 자동 시드에 사용되며, 고객사 BFF 의 {@code /users/auth} 시드에도 쓸 수 있다.</p>
+     * <p>예전에는 {@code registerUser} 가 이 값을 자동으로 실어 보냈는데 그 경로가 사라졌다.
+     * 지금은 호출자가 직접 감지해 {@code PUT /api/v1/users/update} 의 {@code preferredLanguage}
+     * 로 넣어야 한다 — 넣지 않으면 사용자 기본 언어가 미설정으로 남아 자동 번역이 서버 기본값을 쓴다.</p>
      * @returns {string|null}
      */
     static detectBrowserLanguage() {
@@ -398,16 +451,32 @@ class TalkFlowClient extends EventEmitter {
     }
 
     /**
-     * 사용자 존재 여부 확인
-     * @param {string} projectUserId - 프로젝트 사용자 ID
-     * @returns {Promise<Object>}
+     * 회사 조직도 + 인원 — <b>방 만들 때 «조직으로 초대»</b> 가 쓴다.
+     *
+     * <p>조직을 고르면 <b>하위 조직 인원까지</b> 초대된다. 그래서 각 노드의 {@code memberCount} 는
+     * 자손을 포함한 누적이고, {@code members} 는 그 노드 <b>직속</b>만이다 — 누적 목록이 필요하면
+     * {@code children} 을 따라 내려가며 모은다(상위마다 중복해 실으면 응답이 제곱으로 커진다).</p>
+     *
+     * <p>부서가 없는 회원은 {@code unassignedMembers} 에 있다. 퇴사·차단 회원은 어디에도 없다.</p>
+     *
+     * @returns {Promise<Object>} `{tree, unassignedMembers, totalMemberCount, membersOmitted}`
+     *
+     * @example
+     * const dir = await client.getCompanyDirectory();
+     * // 조직 하나를 고르면 그 자손까지 전부 모은다
+     * const collect = (node) => [...node.members, ...node.children.flatMap(collect)];
      */
-    async checkUserExists(projectUserId) {
-        return this.apiClient.get(`/api/v1/users/${projectUserId}/exists`);
+    async getCompanyDirectory() {
+        this._checkToken();
+        return this.apiClient.get('/api/v1/company/directory');
     }
 
     /**
      * 사용자 목록 조회
+     *
+     * <p>응답 행에 {@code phone}/{@code orgNodeId}/{@code orgName} 이 포함된다 — 부서명은
+     * 저장값이 아니라 조회 시점에 조직 마스터에서 해소한 값이다.</p>
+     *
      * @param {Object} [params]
      * @param {number} [params.size=50] - 페이지 크기 (1-100)
      * @param {string} [params.lastId] - 마지막 사용자 ID
@@ -441,9 +510,9 @@ class TalkFlowClient extends EventEmitter {
     _checkToken() {
         if (!this.options.jwtToken) {
             throw new Error(
-                'JWT token is required for this operation. Obtain it from your backend ' +
-                '(POST /api/v1/users/auth with Server API Key) and pass it via setToken(). ' +
-                'See README "프로덕션 인증 플로우".'
+                'JWT token is required for this operation. Sign in with ' +
+                'TalkFlowClient.loginUser({ serverUrl, email, password }) and pass the ' +
+                'returned accessToken via setToken(). See README "로그인".'
             );
         }
     }

package/src/chat/ChatClient.js

@@ -376,7 +376,7 @@ class ChatClient extends EventEmitter {
 
     /**
      * 1:1 채팅방 생성/조회
-     * @param {string} friendId - 상대방 사용자 ID (projectUserId)
+     * @param {string} friendId - 상대방 사용자 ID (서버 내부 {@code users._id} — 참가자 목록의 userId)
      * @returns {Promise<Object>}
      */
     async createOneToOneRoom(friendId) {

package/src/index.js

@@ -10,35 +10,27 @@
  * 자세한 내용은 README 의 "프로덕션 인증 플로우" 섹션 참고.
  *
  * @example
- * // === 빠른 시작 (개발/프로토타입) — Server Key 사용 ===
+ * // === 시작하기 — 이메일/비밀번호 로그인 ===
  * import TalkFlowClient from '@talkflow/sdk';
  *
- * const client = new TalkFlowClient({
- *   apiKey: 'SERVER_KEY',           // 개발용 Server Key (프로덕션에서는 쓰지 마세요)
- *   projectId: 'your-project-id',
- *   env: 'development'
+ * // 1단계: 로그인. 클라이언트 생성 «전» 에 부른다 — ck/projectId/JWT 를 한 번에 받는다.
+ * const { clientKey, projectId, accessToken } = await TalkFlowClient.loginUser({
+ *   serverUrl: 'https://chat.apiorbit.net',
+ *   email: 'me@example.com',
+ *   password: '••••••••'
  * });
  *
- * await client.registerUser({ userId: 'user-123', nickname: '홍길동' });
- * await client.connect();
- * await client.chat.sendTextMessage('room-id', '안녕하세요!');
- *
- * @example
- * // === 프로덕션 — Client Key + Backend JWT 발급 ===
- * // 1단계: 고객사 backend 에서 Server Key 로 JWT 발급
- * //   POST /api/v1/users/auth (X-API-KEY: SERVER_KEY)
- * //   → { accessToken }
- *
- * // 2단계: 브라우저 SDK 는 Client Key + JWT 로 초기화
+ * // 2단계: 받은 값 그대로 초기화
  * const client = new TalkFlowClient({
- *   apiKey: 'CLIENT_KEY',           // 브라우저 노출 안전 (registerUser 서버 차단)
- *   projectId: 'your-project-id',
- *   jwtToken: receivedJwt,          // 백엔드로부터 받은 JWT
+ *   apiKey: clientKey,              // ck- (브라우저 노출 안전)
+ *   projectId,
+ *   jwtToken: accessToken,
  *   env: 'production'
  * });
  *
  * await client.connect();
  * await client.chat.sendTextMessage('room-id', '안녕하세요!');
+ * await client.chat.sendTextMessage('room-id', '안녕하세요!');
  */
 
 // 메인 클라이언트

package/src/talkflow/session.js

@@ -62,9 +62,9 @@ export function applySessionMethods(TalkFlowClient) {
 
         if (!this.options.jwtToken) {
             throw new Error(
-                'JWT token is required. Obtain it from your backend (which calls ' +
-                'POST /api/v1/users/auth with a Server API Key) and pass it to the SDK ' +
-                'via the jwtToken option, setToken(), or connect(jwt). See README "프로덕션 인증 플로우".'
+                'JWT token is required. Sign in with TalkFlowClient.loginUser({ serverUrl, ' +
+                'email, password }) and pass the returned accessToken to the SDK via the ' +
+                'jwtToken option, setToken(), or connect(jwt). See README "로그인".'
             );
         }
 

package/types/index.d.ts

@@ -725,8 +725,6 @@ export interface ChatMessage {
     nickName?: string;
     /** 발신자 프로필 이미지 URL. */
     profileUrl?: string | null;
-    /** 발신자의 프로젝트 스코프 사용자 ID. */
-    projectUserId?: string;
     content: string | null;
     chatMessageType: ChatMessageTypeValue;
     chatType: string;
@@ -962,12 +960,102 @@ export interface DecisionResponse {
     optionId: string;
 }
 
+/** 로그인한 회원. `userId` 는 메시지 발신자 식별과 같은 값이다. */
+export interface LoginMember {
+    userId: string;
+    email?: string | null;
+    nickname?: string | null;
+    profileUrl?: string | null;
+    /** 회사 역할 — 클라이언트가 파트너 화면 노출을 결정한다. 인가 근거는 아니다(서버가 재확인). */
+    companyRole: 'PARTNER' | 'MEMBER';
+    preferredLanguage?: string | null;
+    /**
+     * 초기 비밀번호를 아직 안 바꿨는가 — `true` 면 **비밀번호 변경 화면으로 보내라**.
+     *
+     * 회원은 파트너가 정한 임시 비밀번호로 처음 들어오고, 파트너가 초기화하면 다시 이 상태가 된다.
+     * 로그인은 **성공** 한 것이다 — 실패로 다루면 사용자가 「비밀번호가 틀렸다」로 오해한다.
+     */
+    mustChangePassword: boolean;
+}
+
+/**
+ * `TalkFlowClient.loginUser` 응답.
+ *
+ * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가 함께 정해진다.
+ */
+export interface LoginResult {
+    accessToken: string;
+    tokenType: string;
+    expiresIn?: number;
+    projectId: string;
+    /** 회사의 활성 ck- 키. SDK 초기화의 `apiKey` 로 그대로 넣는다. */
+    clientKey: string;
+    user: LoginMember;
+}
+
+/** 회사 조직도의 회원 — 초대 UI 에 필요한 것만. */
+export interface DirectoryMember {
+    userId: string;
+    name?: string | null;
+    profileUrl?: string | null;
+}
+
+/** 조직도 노드. `parentId` 가 null 이면 최상위. */
+export interface DirectoryNode {
+    orgNodeId: string;
+    name: string;
+    parentId?: string | null;
+    sortOrder: number;
+    /** 자손 포함 누적 인원 — 화면의 「개발팀 (2)」가 이 값. */
+    memberCount: number;
+    /** 이 노드 직속 인원 수. */
+    directMemberCount: number;
+    /** 이 노드 **직속** 회원. 누적 목록은 `children` 을 따라 모은다. */
+    members: DirectoryMember[];
+    children: DirectoryNode[];
+}
+
+/** `getCompanyDirectory()` 응답. */
+export interface CompanyDirectory {
+    tree: DirectoryNode[];
+    /** 부서가 없는 회원 — 빠지면 초대 화면에서 그 사람을 찾을 수 없다. */
+    unassignedMembers: DirectoryMember[];
+    /** 활성 회원 총수(트리 + 미지정). */
+    totalMemberCount: number;
+    /** true 면 인원 **수** 는 정확하지만 **목록** 이 비어 있다 — 검색 기반 선택으로 넘어가야 한다. */
+    membersOmitted: boolean;
+}
+
+/** 내 정보. 수정 응답에는 `accessToken` 이 함께 온다(name/profileUrl 이 토큰 claim). */
+export interface MyProfile {
+    userId: string;
+    email?: string | null;
+    name?: string | null;
+    phone?: string | null;
+    profileUrl?: string | null;
+    /** 회사 역할 — 방 역할(ParticipantResponse.role)과 다른 축이다. */
+    companyRole: 'PARTNER' | 'MEMBER';
+    orgNodeId?: string | null;
+    orgName?: string | null;
+    preferredLanguage?: string | null;
+    projectId: string;
+    joinedAt?: string | null;
+    /**
+     * 초기 비밀번호를 아직 안 바꿨는가 — `true` 면 비밀번호 변경을 요구해야 한다.
+     *
+     * 로그인 응답에도 같은 값이 있다. 여기에도 있는 이유: 새로고침·딥링크로 로그인 응답을 거치지
+     * 않고 들어오는 화면에서 그 요구가 조용히 사라지지 않게 하려는 것이다.
+     */
+    mustChangePassword: boolean;
+    accessToken?: string;
+    expiresIn?: number;
+}
+
 /** 채팅방 참가자. */
 export interface ParticipantResponse {
     userId: string;
     nickName?: string;
     profileUrl?: string | null;
-    projectUserId?: string;
     /**
      * 참가자 역할 — 서버 {@code ParticipantRole} enum 과 일치.
      * <ul>
@@ -2251,6 +2339,30 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     removeAllListeners(event?: keyof TalkFlowClientEvents): void;
     listenerCount(event: keyof TalkFlowClientEvents): number;
 
+    // 회원 인증 · 내 정보
+    /**
+     * 회원 로그인 — 클라이언트 생성 **전에** 호출한다. Server Key 도 고객사 BFF 도 필요 없다.
+     * 응답의 `clientKey`/`projectId`/`accessToken` 이 그대로 SDK 초기화 입력이다.
+     * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이다.
+     */
+    static loginUser(options: {
+        serverUrl: string;
+        email: string;
+        password: string;
+    }): Promise<LoginResult>;
+
+    /** 회원 로그인 (인스턴스) — 재로그인·계정 전환용. 성공 시 토큰을 자동 설정한다. */
+    loginUser(credentials: { email: string; password: string }): Promise<LoginResult>;
+
+    /** 내 정보 조회. */
+    getMyProfile(): Promise<MyProfile>;
+
+    /** 내 정보 수정 — 응답의 새 토큰을 자동 채택한다(name/profileUrl 이 토큰 claim). */
+    updateMyProfile(profile: { name?: string; phone?: string; profileUrl?: string }): Promise<MyProfile>;
+
+    /** 비밀번호 변경 — 현재 비밀번호 재확인. 토큰은 그대로 유효해 재로그인이 필요 없다. */
+    changeMyPassword(params: { currentPassword: string; newPassword: string }): Promise<unknown>;
+
     // Connection lifecycle
     connect(jwt?: string, options?: ConnectOptions): Promise<void>;
     disconnect(): Promise<void>;