@vibexnpm/talkx 8.13.0 → 9.1.0

package/src/utils/ApiClient.js

@@ -104,58 +104,62 @@ class ApiClient {
             }
         }
 
-        // AbortController for timeout
+        // 시간 상한은 본문을 다 읽을 때까지다 — 헤더만 오고 본문이 멈춰도 끝나게(AuthSession._request 와 같다). 끊으면 본문 읽기도 AbortError 로
+        // 끝난다.
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
 
-        let response;
         try {
-            this.logger.debug(`${method} ${url}`);
-
-            response = await fetch(url, {
-                method,
-                headers: { ...this._getHeaders(), ...headers },
-                credentials: this.authProvider ? 'omit' : 'same-origin',
-                body: body ? JSON.stringify(body) : undefined,
-                signal: controller.signal
-            });
-        } catch (error) {
-            clearTimeout(timeoutId);
-
-            if (error.name === 'AbortError') {
-                const timeoutError = new Error('Request timeout');
-                timeoutError.code = ErrorTypes.API_TIMEOUT;
-                throw timeoutError;
+            let response;
+            try {
+                this.logger.debug(`${method} ${url}`);
+
+                response = await fetch(url, {
+                    method,
+                    headers: { ...this._getHeaders(), ...headers },
+                    credentials: this.authProvider ? 'omit' : 'same-origin',
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal
+                });
+            } catch (error) {
+                if (error.name !== 'AbortError') {
+                    this.logger.error(`API Error: ${method} ${url}`, error);
+                }
+                throw error;
             }
 
-            this.logger.error(`API Error: ${method} ${url}`, error);
-            throw error;
-        }
-
-        clearTimeout(timeoutId);
+            // 응답 파싱
+            const contentType = response.headers.get('content-type');
+            let data;
 
-        // 응답 파싱
-        const contentType = response.headers.get('content-type');
-        let data;
+            if (contentType && contentType.includes('application/json')) {
+                data = await response.json();
+            } else {
+                data = await response.text();
+            }
 
-        if (contentType && contentType.includes('application/json')) {
-            data = await response.json();
-        } else {
-            data = await response.text();
-        }
+            // 에러 처리
+            if (!response.ok) {
+                const error = new Error(data?.message || `HTTP ${response.status}`);
+                error.code = ErrorTypes.API_ERROR;
+                error.status = response.status;
+                error.response = data;
+                this.logger.error(`API Error: ${method} ${url}`, error);
+                throw error;
+            }
 
-        // 에러 처리
-        if (!response.ok) {
-            const error = new Error(data?.message || `HTTP ${response.status}`);
-            error.code = ErrorTypes.API_ERROR;
-            error.status = response.status;
-            error.response = data;
-            this.logger.error(`API Error: ${method} ${url}`, error);
+            this.logger.debug(`Response ${response.status}`);
+            return data;
+        } catch (error) {
+            if (error?.name === 'AbortError') {
+                const timeoutError = new Error('Request timeout');
+                timeoutError.code = ErrorTypes.API_TIMEOUT;
+                throw timeoutError;
+            }
             throw error;
+        } finally {
+            clearTimeout(timeoutId);
         }
-
-        this.logger.debug(`Response ${response.status}`);
-        return data;
     }
 
     // HTTP 메서드 헬퍼

package/src/webrtc/CallLedger.js

@@ -0,0 +1,135 @@
+/**
+ * CallLedger
+ * 통화 이벤트 장부 — 브라우저·LiveKit 없이 판정만 한다(화상통화 SFU 설계 v0.7 I8·§5.3).
+ *
+ * <ul>
+ *   <li>중복 전달은 버린다 — 같은 (version, 종류) 는 한 번만.</li>
+ *   <li>«지금 상태» 를 뜻하는 이벤트(초대)는 본 것보다 낡은 version 이면 버린다 — 통화가 이미 그 뒤로 나아갔다. 거절·응답·취소·종료처럼
+ *       «일어난 일» 을 알리는 이벤트는 늦게 와도 버리지 않는다(두 사람의 거절이 역순으로 와도 둘 다 방장에게 간다).</li>
+ *   <li>서버가 끝냈다고 알린 통화는 묘비로 기억한다 — 늦게 온 초대가 다시 울리지 않게. 이 기기만 나간 것(나가기·재접속 실패·다른 기기로
+ *       옮김)은 묘비가 아니다 — 다시 들어갈 수 있다.</li>
+ *   <li>울림 정지 표식은 version 과 따로 둔다 — «응답함»·«취소» 를 한 번 받으면 그 통화의 울림을 되살리지 않는다.</li>
+ * </ul>
+ */
+
+/** 기억하는 통화 수 상한 — 오래된 것부터 잊는다(초대·종료는 짧게만 의미가 있다). */
+const DEFAULT_MAX_CALLS = 64;
+/** 통화 하나에서 기억하는 (version, 종류) 수 상한. */
+const MAX_SEEN_PER_CALL = 64;
+
+class CallLedger {
+    /**
+     * @param {Object} [options]
+     * @param {number} [options.maxCalls=64]
+     */
+    constructor({ maxCalls = DEFAULT_MAX_CALLS } = {}) {
+        this._maxCalls = maxCalls;
+        /** @type {Map<string, {version: number|null, seen: Set<string>, ended: {reason: string}|null, ringStopped: boolean}>} */
+        this._calls = new Map();
+    }
+
+    /**
+     * 본 version 보다 낡았나 — 초대처럼 «지금 상태» 를 뜻하는 이벤트에만 쓴다.
+     * @param {string} callRoomId
+     * @param {number} version
+     * @returns {boolean}
+     */
+    isStale(callRoomId, version) {
+        const entry = this._calls.get(callRoomId);
+        return Boolean(entry && Number.isFinite(version) && entry.version !== null && version < entry.version);
+    }
+
+    /**
+     * 이벤트를 기억한다 — 처음 보는 (version, 종류) 면 true, 이미 본 것(중복 전달)이면 false. 최신 version 을 올린다.
+     * @param {string} callRoomId
+     * @param {number} version
+     * @param {string} type
+     * @returns {boolean}
+     */
+    record(callRoomId, version, type) {
+        const entry = this._entry(callRoomId);
+        if (!Number.isFinite(version)) {
+            return true;
+        }
+        const key = `${version}:${type}`;
+        if (entry.seen.has(key)) {
+            return false;
+        }
+        entry.seen.add(key);
+        if (entry.seen.size > MAX_SEEN_PER_CALL) {
+            entry.seen.delete(entry.seen.values().next().value);
+        }
+        if (entry.version === null || version > entry.version) {
+            entry.version = version;
+        }
+        return true;
+    }
+
+    /**
+     * REST 응답 등에서 본 version 을 바닥으로 올린다 — 그보다 낡은 초대는 이후 버린다.
+     * @param {string} callRoomId
+     * @param {number} version
+     */
+    observe(callRoomId, version) {
+        if (!Number.isFinite(version)) {
+            return;
+        }
+        const entry = this._entry(callRoomId);
+        if (entry.version === null || version > entry.version) {
+            entry.version = version;
+        }
+    }
+
+    /**
+     * 서버가 끝냈다고 알린 통화로 기억한다(묘비). 처음 사유가 남는다.
+     * @param {string} callRoomId
+     * @param {string} reason
+     */
+    markEnded(callRoomId, reason) {
+        const entry = this._entry(callRoomId);
+        if (!entry.ended) {
+            entry.ended = { reason };
+        }
+        entry.ringStopped = true;
+    }
+
+    /**
+     * @param {string} callRoomId
+     * @returns {string|null} 서버에서 끝났으면 그 사유, 아니면 null
+     */
+    endedReason(callRoomId) {
+        return this._calls.get(callRoomId)?.ended?.reason ?? null;
+    }
+
+    /** @param {string} callRoomId */
+    stopRinging(callRoomId) {
+        this._entry(callRoomId).ringStopped = true;
+    }
+
+    /**
+     * @param {string} callRoomId
+     * @returns {boolean} 울림을 되살리면 안 되는가(정지 표식 또는 묘비)
+     */
+    isRingStopped(callRoomId) {
+        const entry = this._calls.get(callRoomId);
+        return Boolean(entry && (entry.ringStopped || entry.ended));
+    }
+
+    _entry(callRoomId) {
+        let entry = this._calls.get(callRoomId);
+        if (entry) {
+            // 최근에 쓴 통화를 뒤로 옮겨 오래된 것부터 잊게 한다.
+            this._calls.delete(callRoomId);
+            this._calls.set(callRoomId, entry);
+            return entry;
+        }
+        entry = { version: null, seen: new Set(), ended: null, ringStopped: false };
+        this._calls.set(callRoomId, entry);
+        while (this._calls.size > this._maxCalls) {
+            this._calls.delete(this._calls.keys().next().value);
+        }
+        return entry;
+    }
+}
+
+export default CallLedger;