@vibexnpm/talkx 5.6.0 → 7.0.0

package/dist/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>;