@vibexnpm/talkx 5.6.0 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "5.6.0",
+    "version": "7.0.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 를 그대로 쓰세요.'
+            );
         }
     }
 
@@ -240,7 +225,7 @@ class TalkFlowClient extends EventEmitter {
     /**
      * 회원 로그인 — 이메일/비밀번호로 채팅 접속 일체를 받는다. **클라이언트 생성 전에 호출한다.**
      *
-     * <p>{@link #registerUser} 와 달리 Server Key 도 고객사 BFF 도 필요 없다. 응답의
+     * <p>Server Key 도 고객사 BFF 도 필요 없다. 응답의
      * {@code clientKey}/{@code projectId}/{@code accessToken} 이 그대로 SDK 초기화 입력이다.</p>
      *
      * <p><b>회사 선택 단계가 없다</b>: 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가
@@ -302,7 +287,16 @@ class TalkFlowClient extends EventEmitter {
     /**
      * 내 정보 조회.
      *
-     * @returns {Promise<Object>} `{userId, email, name, phone, profileUrl, companyRole, orgNodeId, orgName, ...}`
+     * `metadata` 를 볼 수 있는 **유일한** 곳이다. 고치는 문은 {@link #updateMyProfile} 하나뿐이고
+     * 그쪽은 **전체 교체**라, 부분 수정하려면 여기서 먼저 읽어 병합한 뒤 통째로 보내야 한다:
+     *
+     * ```js
+     * const me = await client.getMyProfile();
+     * await client.updateMyProfile({ metadata: { ...me.metadata, statusMessage: '회의 중' } });
+     * ```
+     *
+     * @returns {Promise<Object>} `{userId, email, name, phone, profileUrl, companyRole,
+     *   orgNodeId, orgName, preferredLanguage, metadata, mustChangePassword, ...}`
      */
     async getMyProfile() {
         this._checkToken();
@@ -319,10 +313,24 @@ class TalkFlowClient extends EventEmitter {
      * <p>이메일·조직·역할은 바꿀 수 없다 — 이메일은 로그인 키, 조직은 파트너가 정하고,
      * 역할은 본인이 승급할 수 없어야 한다.</p>
      *
-     * @param {Object} profile
-     * @param {string} [profile.name]
-     * @param {string} [profile.phone]
-     * @param {string} [profile.profileUrl]
+     * <p><b>내 정보를 고치는 유일한 메서드다.</b> {@code updateMyInfo} 와
+     * {@code PUT /api/v1/users/update} 는 v7.0.0 에서 걷어냈다 — 같은 칸(이름·프로필 이미지)을
+     * 고치는 문이 둘이라 한 화면에서 순서 없이 두 번 부르면 나중 호출이 앞을 덮었고, 어느 쪽도
+     * 혼자서는 부족했다(그쪽엔 {@code phone} 이, 이쪽엔 나머지 셋이 없었다).</p>
+     *
+     * <p>서버는 갱신된 프로필이 담긴 <b>새 JWT</b> 를 함께 준다. 채택하지 않으면 옛 토큰의
+     * name/profileUrl 클레임이 최대 7일(토큰 TTL) 동안 계속 나간다. 같은 사용자의 토큰 교체라
+     * {@code setToken} 은 재연결을 일으키지 않는다 — STOMP connectHeaders 만 갱신된다.</p>
+     *
+     * @param {Object} profile — 넘기지 않은 필드는 «변경 안 함»
+     * @param {string} [profile.name] - 이름 (max 100자)
+     * @param {string} [profile.phone] - 전화번호 (max 30자)
+     * @param {string} [profile.profileUrl] - 프로필 이미지 URL (max 500자)
+     * @param {Object} [profile.metadata] - 메타데이터 (**전체 교체** — 부분 수정하려면
+     *   {@link #getMyProfile} 로 현재 값을 읽어 병합한 뒤 통째로 보내라. 서버는 병합하지 않는다)
+     * @param {string|null} [profile.preferredLanguage] - 기본 선호 언어 (BCP-47 / 'OFF'(원문) / null)
+     * @param {string} [profile.timeZone] - IANA zone id. 어시가 대화 시각을 이 기준으로 렌더한다.
+     *   `Intl.DateTimeFormat().resolvedOptions().timeZone` 값을 그대로 보내면 된다.
      * @returns {Promise<Object>} 갱신된 내 정보 (accessToken 포함)
      */
     async updateMyProfile(profile) {
@@ -357,106 +365,13 @@ class TalkFlowClient extends EventEmitter {
         return this.apiClient.put('/api/v1/me/password', { currentPassword, newPassword });
     }
 
-    /**
-     * 사용자 인증 (등록/로그인).
-     * 인증 성공 시 반환된 JWT 토큰을 자동으로 설정합니다.
-     *
-     * <h3>⚠️ DEPRECATED — {@link TalkFlowClient.loginUser} 로 대체</h3>
-     * <p>고객사 앱이 자기 회원 ID 를 들고 오던 경로다. 서버에서 {@code POST /api/v1/users/auth} 가
-     * 제거될 예정이며 그때 이 메서드도 함께 사라진다. 신규 코드는 {@code loginUser} 를 쓴다.</p>
-     *
-     * <h3>⚠️ Server API Key 전용</h3>
-     * <p>이 메서드는 JWT 를 발급하는 엔드포인트 ({@code POST /api/v1/users/auth}) 를 호출합니다.
-     * <strong>프로덕션 환경에서는 Client API Key 로 이 메서드를 호출하면 서버가 403 을 반환합니다.</strong></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>자세한 내용은 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>} 인증 결과 (토큰 포함)
-     *
-     * @example
-     * // 개발 환경 — Server Key 로 빠른 테스트
-     * const client = new TalkFlowClient({
-     *     apiKey: 'SERVER_KEY',
-     *     projectId: 'your-project-id',
-     *     env: 'development'
-     * });
-     * 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;
-            }
-        }
-
-        const response = await this.apiClient.post('/api/v1/users/auth', payload);
-
-        if (response.data && response.data.accessToken) {
-            await this.setToken(response.data.accessToken);
-            this.logger.info('User authenticated, token auto-set');
-        }
-
-        return response;
-    }
-
-    /**
-     * 사용자 정보 수정.
-     *
-     * 서버는 갱신된 프로필이 담긴 **새 JWT** 를 응답에 함께 실어 준다(`/auth` 와 같은 계약).
-     * 이걸 채택하지 않으면 옛 토큰의 name/profileUrl 클레임이 계속 나가, 서버가 그 클레임을 읽는
-     * 경로에서 낡은 값이 최대 7일(토큰 TTL) 동안 보인다.
-     *
-     * 같은 사용자의 토큰 교체라 `setToken` 은 재연결을 일으키지 않는다 — userId 가 바뀔 때만
-     * 재초기화하고, 여기서는 STOMP connectHeaders 만 갱신된다.
-     *
-     * @param {Object} userData
-     * @param {string} [userData.nickname] - 닉네임 (max 100자)
-     * @param {string} [userData.profileImageUrl] - 프로필 이미지 URL (max 500자)
-     * @param {Object} [userData.metadata] - 메타데이터 (전체 교체)
-     * @param {string|null} [userData.preferredLanguage] - 기본 선호 언어 (BCP-47 / 'OFF'(원문) / null). 다국어.
-     * @returns {Promise<Object>}
-     */
-    async updateMyInfo(userData) {
-        this._checkToken();
-        const response = await this.apiClient.put('/api/v1/users/update', userData);
-
-        if (response?.data?.accessToken) {
-            // 토큰 교체 실패로 수정 자체를 실패시키지 않는다 — 서버 반영은 이미 끝났고,
-            // 옛 토큰도 유효(낡았을 뿐)하므로 여기서 throw 하면 호출자가 이미 적용된 수정을
-            // 다시 시도하게 된다. authenticate() 는 토큰이 없으면 아무것도 못 하므로 계약이 다르다.
-            try {
-                await this.setToken(response.data.accessToken);
-            } catch (error) {
-                this.logger.warn('Profile updated but token refresh failed; keeping the old token', error);
-            }
-        }
-
-        return response;
-    }
-
     /**
      * 내 기본 선호 언어 설정 (전 방 공통, 다국어). 명시 변경 — 방별 오버라이드는 {@link #setMyRoomLanguage}.
      * @param {string|null} language - BCP-47 코드(예 'ko','en') / 'OFF'(원문) / null·''(미설정)
      * @returns {Promise<Object>}
      */
     async setPreferredLanguage(language) {
-        return this.updateMyInfo({ preferredLanguage: language });
+        return this.updateMyProfile({ preferredLanguage: language });
     }
 
     /**
@@ -468,7 +383,10 @@ class TalkFlowClient extends EventEmitter {
      * 지역 변형을 그대로 보내면 명시 요청({@code lang: 'en'})과 키가 분열되어 같은 언어 이중 생성·조회 miss 가
      * 발생한다. 서버 {@code LanguageCode} 도 동일 규칙으로 축약하므로 어느 쪽으로 들어와도 같은 값이 된다.</p>
      *
-     * <p>{@link #registerUser} 자동 시드에 사용되며, 고객사 BFF 의 {@code /users/auth} 시드에도 쓸 수 있다.</p>
+     * <p>예전에는 {@code registerUser} 가 이 값을 자동으로 실어 보냈는데 그 경로가 사라졌다.
+     * 지금은 호출자가 직접 감지해 {@link #setPreferredLanguage} (또는 {@link #updateMyProfile} 의
+     * {@code preferredLanguage}) 로 넣어야 한다 — 넣지 않으면 사용자 기본 언어가 미설정으로 남아
+     * 자동 번역이 서버 기본값을 쓴다.</p>
      * @returns {string|null}
      */
     static detectBrowserLanguage() {
@@ -522,16 +440,37 @@ 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 email}/{@code phone}/{@code orgNodeId}/{@code orgName} 이 포함된다 —
+     * 부서명은 저장값이 아니라 조회 시점에 조직 마스터에서 해소한 값이다.</p>
+     *
+     * <p>{@code email} 은 <b>연락용</b>이다. 로그인 키인 {@code loginEmail} 은 어떤 목록에도
+     * 실리지 않는다 — 둘은 다른 값이고, 퇴사 시 {@code loginEmail} 만 비워진다.</p>
+     *
+     * <p>퇴사·차단된 회원은 목록·검색 어디에도 나오지 않는다.</p>
+     *
      * @param {Object} [params]
      * @param {number} [params.size=50] - 페이지 크기 (1-100)
      * @param {string} [params.lastId] - 마지막 사용자 ID
@@ -565,9 +504,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;
@@ -968,7 +966,16 @@ export interface LoginMember {
     email?: string | null;
     nickname?: string | null;
     profileUrl?: string | null;
+    /** 회사 역할 — 클라이언트가 파트너 화면 노출을 결정한다. 인가 근거는 아니다(서버가 재확인). */
+    companyRole: 'PARTNER' | 'MEMBER';
     preferredLanguage?: string | null;
+    /**
+     * 초기 비밀번호를 아직 안 바꿨는가 — `true` 면 **비밀번호 변경 화면으로 보내라**.
+     *
+     * 회원은 파트너가 정한 임시 비밀번호로 처음 들어오고, 파트너가 초기화하면 다시 이 상태가 된다.
+     * 로그인은 **성공** 한 것이다 — 실패로 다루면 사용자가 「비밀번호가 틀렸다」로 오해한다.
+     */
+    mustChangePassword: boolean;
 }
 
 /**
@@ -986,6 +993,39 @@ export interface LoginResult {
     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;
@@ -998,8 +1038,24 @@ export interface MyProfile {
     orgNodeId?: string | null;
     orgName?: string | null;
     preferredLanguage?: string | null;
+    /**
+     * 확장 메타데이터 — 내 값을 볼 수 있는 **유일한** 곳이다.
+     *
+     * 고치는 문은 `updateMyProfile({ metadata })` 하나뿐이고 **전체 교체**다 —
+     * 서버는 병합하지 않는다. 부분 수정하려면 이 값을 먼저 읽어 병합한 뒤 통째로 보내라.
+     */
+    metadata?: Record<string, unknown> | null;
+    /** IANA zone id — 어시가 대화 시각을 이 기준으로 렌더한다. 읽을 수 없으면 설정 화면이 현재 값을 못 보여준다. */
+    timeZone?: string | null;
     projectId: string;
     joinedAt?: string | null;
+    /**
+     * 초기 비밀번호를 아직 안 바꿨는가 — `true` 면 비밀번호 변경을 요구해야 한다.
+     *
+     * 로그인 응답에도 같은 값이 있다. 여기에도 있는 이유: 새로고침·딥링크로 로그인 응답을 거치지
+     * 않고 들어오는 화면에서 그 요구가 조용히 사라지지 않게 하려는 것이다.
+     */
+    mustChangePassword: boolean;
     accessToken?: string;
     expiresIn?: number;
 }
@@ -1009,7 +1065,6 @@ export interface ParticipantResponse {
     userId: string;
     nickName?: string;
     profileUrl?: string | null;
-    projectUserId?: string;
     /**
      * 참가자 역할 — 서버 {@code ParticipantRole} enum 과 일치.
      * <ul>
@@ -2312,7 +2367,17 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     getMyProfile(): Promise<MyProfile>;
 
     /** 내 정보 수정 — 응답의 새 토큰을 자동 채택한다(name/profileUrl 이 토큰 claim). */
-    updateMyProfile(profile: { name?: string; phone?: string; profileUrl?: string }): Promise<MyProfile>;
+    updateMyProfile(profile: {
+        name?: string;
+        phone?: string;
+        profileUrl?: string;
+        /** **전체 교체** — 부분 수정은 `getMyProfile()` 로 읽어 병합한 뒤 통째로 보낸다. */
+        metadata?: Record<string, unknown> | null;
+        /** BCP-47 코드 / 'OFF'(원문) / null */
+        preferredLanguage?: string | null;
+        /** IANA zone id — `Intl.DateTimeFormat().resolvedOptions().timeZone` */
+        timeZone?: string;
+    }): Promise<MyProfile>;
 
     /** 비밀번호 변경 — 현재 비밀번호 재확인. 토큰은 그대로 유효해 재로그인이 필요 없다. */
     changeMyPassword(params: { currentPassword: string; newPassword: string }): Promise<unknown>;