@vibexnpm/talkx 5.4.0 → 6.1.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;
@@ -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>;