@vibexnpm/talkx 3.0.4 → 3.0.6

package/package.json

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

package/src/TalkFlowClient.js

@@ -299,7 +299,14 @@ class TalkFlowClient extends EventEmitter {
     }
 
     /**
-     * 브라우저 locale 감지 — {@code navigator.language} 를 BCP-47 소문자로 정규화. 비브라우저/미가용 시 null.
+     * 브라우저 locale 감지 — {@code navigator.language} 를 BCP-47 소문자로 정규화하고 지역 변형을 primary 로
+     * 축약한다({@code ko-KR → 'ko'}, {@code en-US → 'en'}). 단 {@code zh} 계열은 간체/번체 구분을 위해
+     * 변형을 보존한다({@code zh-TW → 'zh-tw'}). 비브라우저/미가용 시 null.
+     *
+     * <p>축약 이유(값공간 통일): 서버 저장·번역·요약 키는 짧은 코드({@code 'ko'}/{@code 'en'}) 기준이다. 시드가
+     * 지역 변형을 그대로 보내면 명시 요청({@code lang: 'en'})과 키가 분열되어 같은 언어 이중 생성·조회 miss 가
+     * 발생한다. 서버 {@code LanguageCode} 도 동일 규칙으로 축약하므로 어느 쪽으로 들어와도 같은 값이 된다.</p>
+     *
      * <p>{@link #registerUser} 자동 시드에 사용되며, 고객사 BFF 의 {@code /users/auth} 시드에도 쓸 수 있다.</p>
      * @returns {string|null}
      */
@@ -307,7 +314,33 @@ class TalkFlowClient extends EventEmitter {
         if (typeof navigator === 'undefined' || !navigator.language) {
             return null;
         }
-        return navigator.language.trim().toLowerCase() || null;
+        return TalkFlowClient.normalizeLanguageCode(navigator.language);
+    }
+
+    /**
+     * 언어 코드 canonical 정규화 — 소문자 + 지역 변형 축약(zh 계열 보존). 서버 {@code LanguageCode} 규칙의 미러.
+     * <p>{@code 'OFF'}(원문 sentinel)는 대문자 그대로 유지한다. 빈 값은 null.</p>
+     * @param {string|null|undefined} code - BCP-47 코드(예 'ko-KR') / 'OFF' / null
+     * @returns {string|null}
+     */
+    static normalizeLanguageCode(code) {
+        if (!code || typeof code !== 'string') {
+            return null;
+        }
+        const trimmed = code.trim();
+        if (!trimmed) {
+            return null;
+        }
+        if (trimmed.toUpperCase() === 'OFF') {
+            return 'OFF';
+        }
+        const lower = trimmed.toLowerCase();
+        const dash = lower.indexOf('-');
+        if (dash < 0) {
+            return lower;
+        }
+        const primary = lower.slice(0, dash);
+        return primary === 'zh' ? lower : primary;
     }
 
     /**
@@ -319,8 +352,10 @@ class TalkFlowClient extends EventEmitter {
      * @returns {string|null}
      */
     static displayText(message, myLang) {
-        if (message && message.translations && myLang && message.translations[myLang]) {
-            return message.translations[myLang];
+        // myLang 도 canonical 로 정규화 — 앱이 'ko-KR' 처럼 지역 변형을 넘겨도 서버 저장 키('ko')와 일치시킨다.
+        const lang = TalkFlowClient.normalizeLanguageCode(myLang);
+        if (message && message.translations && lang && message.translations[lang]) {
+            return message.translations[lang];
         }
         return message ? message.content : null;
     }

package/types/index.d.ts

@@ -1735,9 +1735,11 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     // 다국어 (Multilingual)
     /** 내 기본 선호 언어 설정 (전 방 공통) — BCP-47 / 'OFF'(원문) / null·''(미설정). 방별은 setMyRoomLanguage. */
     setPreferredLanguage(language: string | null): Promise<unknown>;
-    /** 브라우저 locale 감지 — navigator.language 를 BCP-47 소문자로. 비브라우저/미가용 시 null. */
+    /** 브라우저 locale 감지 — 소문자 + 지역 변형 축약('ko-KR'→'ko', zh 계열은 'zh-tw' 보존). 비브라우저/미가용 시 null. */
     static detectBrowserLanguage(): string | null;
-    /** 표시 헬퍼 — message.translations[myLang] ?? message.content. */
+    /** 언어 코드 canonical 정규화 — 소문자 + 지역 변형 축약(zh 보존). 서버 LanguageCode 규칙 미러. 'OFF' 는 유지. */
+    static normalizeLanguageCode(code: string | null | undefined): string | null;
+    /** 표시 헬퍼 — message.translations[myLang] ?? message.content. myLang 은 자동 canonical 정규화. */
     static displayText(message: ChatMessage, myLang?: string): string | null;
 
     // Push