@vibexnpm/talkx 5.4.0 → 5.6.0

package/package.json

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

package/src/TalkFlowClient.js

@@ -237,10 +237,134 @@ class TalkFlowClient extends EventEmitter {
 
     // ==================== 사용자 API ====================
 
+    /**
+     * 회원 로그인 — 이메일/비밀번호로 채팅 접속 일체를 받는다. **클라이언트 생성 전에 호출한다.**
+     *
+     * <p>{@link #registerUser} 와 달리 Server Key 도 고객사 BFF 도 필요 없다. 응답의
+     * {@code clientKey}/{@code projectId}/{@code accessToken} 이 그대로 SDK 초기화 입력이다.</p>
+     *
+     * <p><b>회사 선택 단계가 없다</b>: 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가
+     * 함께 정해진다. 퇴사하면 그 키가 풀려 다른 회사에서 같은 이메일을 다시 쓸 수 있다.</p>
+     *
+     * @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
+     * const login = await TalkFlowClient.loginUser({
+     *     serverUrl: 'https://chat.apiorbit.net',
+     *     email: 'dan@example.com',
+     *     password: '********'
+     * });
+     *
+     * const client = new TalkFlowClient({
+     *     apiKey: login.clientKey,
+     *     projectId: login.projectId,
+     *     jwtToken: login.accessToken
+     * });
+     * await client.connect();
+     */
+    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;
+    }
+
+    /**
+     * 내 정보 조회.
+     *
+     * @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;
+    }
+
+    /**
+     * 내 정보 수정 — 이름·전화번호·프로필 이미지.
+     *
+     * <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;
+    }
+
+    /**
+     * 비밀번호 변경 — 현재 비밀번호를 재확인한다.
+     *
+     * <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 });
+    }
+
     /**
      * 사용자 인증 (등록/로그인).
      * 인증 성공 시 반환된 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>

package/types/index.d.ts

@@ -962,6 +962,48 @@ export interface DecisionResponse {
     optionId: string;
 }
 
+/** 로그인한 회원. `userId` 는 메시지 발신자 식별과 같은 값이다. */
+export interface LoginMember {
+    userId: string;
+    email?: string | null;
+    nickname?: string | null;
+    profileUrl?: string | null;
+    preferredLanguage?: string | null;
+}
+
+/**
+ * `TalkFlowClient.loginUser` 응답.
+ *
+ * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가 함께 정해진다.
+ */
+export interface LoginResult {
+    accessToken: string;
+    tokenType: string;
+    expiresIn?: number;
+    projectId: string;
+    /** 회사의 활성 ck- 키. SDK 초기화의 `apiKey` 로 그대로 넣는다. */
+    clientKey: string;
+    user: LoginMember;
+}
+
+/** 내 정보. 수정 응답에는 `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;
+    accessToken?: string;
+    expiresIn?: number;
+}
+
 /** 채팅방 참가자. */
 export interface ParticipantResponse {
     userId: string;
@@ -2251,6 +2293,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>;