@solhun/feedback-kit-core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -95,13 +95,22 @@ interface DiagNetworkEntry {
     url: string;
     /** 응답을 못 받았으면(네트워크 실패·중단) null. */
     status: number | null;
+    /**
+     * 2xx 였는가. status 로 계산할 수 있지만 따로 싣는다 —
+     * 제보를 훑는 사람이 실패한 요청만 눈으로 골라내는 게 목적이다.
+     * 응답 자체를 못 받았으면 false.
+     */
+    ok: boolean;
+    /** 네트워크 실패·중단의 사유. 성공했으면 null. 응답 본문은 담지 않는다. */
+    errorMessage: string | null;
     durationMs: number;
     /** 기록 시각(ISO 8601). */
     at: string;
 }
 /** 콘솔 기록 1건. `console.warn` / `console.error` 만 대상. */
 interface DiagLogEntry {
-    level: "warn" | "error";
+    /** `log` 은 captureLogs: "all" 일 때만 담긴다. */
+    level: "log" | "warn" | "error";
     message: string;
     at: string;
 }
@@ -517,14 +526,16 @@ declare const MAX_LOG_MESSAGE_CHARS = 2000;
 interface DiagnosticsInstallOpts {
     /** true 를 반환하면 그 요청은 기록하지 않는다(위젯 자신의 전송 등). */
     excludeMatcher?: DiagnosticsExcludeMatcher;
+    /**
+     * 콘솔 로그를 어디까지 담을지. 기본 `problems`(warn·error 만).
+     * `all` 은 log·info 까지 담는다 — 흐름 추적엔 좋지만 평범한 로그가 많은 앱에서는
+     * 그게 제보를 덮어 정작 중요한 경고가 묻힌다. 그래서 프로젝트마다 정한다.
+     */
+    logs?: "problems" | "all" | "off";
     /** 시각 주입(테스트용). */
     now?: () => number;
     iso?: (n: number) => string;
 }
-/**
- * 진단 수집기. `install()` 로 글로벌을 패치하고 `uninstall()` 로 원복한다.
- * 생성 자체는 부작용이 없다 — `install()` 을 호출해야 패치가 일어난다.
- */
 declare class DiagnosticsCollector {
     readonly network: RingBuffer<DiagNetworkEntry>;
     readonly logs: RingBuffer<DiagLogEntry>;
@@ -534,7 +545,9 @@ declare class DiagnosticsCollector {
     private originalXhrSend;
     private originalWarn;
     private originalError;
+    private originalLog;
     private excludeMatcher;
+    private logScope;
     private now;
     private iso;
     /**
@@ -568,6 +581,7 @@ declare class DiagnosticsCollector {
     snapshot(): DiagnosticsPayload;
     /** 두 버퍼를 비운다. */
     clear(): void;
+    /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
     private recordNetwork;
     private recordLog;
     private isExcluded;
@@ -661,6 +675,16 @@ interface FeedbackConfig {
     captureScreenshot?: boolean;
     /** network·logs 링버퍼를 수집할지. false 면 아예 설치하지 않는다. */
     captureDiagnostics?: boolean;
+    /**
+     * 콘솔 로그를 담을 범위. 프로젝트마다 다르다 — 로그를 정돈해 쓰는 팀에는
+     * `all` 이 가장 유용하고, 평범한 로그가 수백 줄씩 나오는 앱에서는 그게
+     * 제보를 덮어 정작 중요한 경고가 묻힌다.
+     *
+     * - `problems`(기본): warn·error 만. 노이즈 없이 문제만 남는다.
+     * - `all`: log·info 까지 전부. 개발 중 흐름 추적에 유리하다.
+     * - `off`: 로그를 담지 않는다. 네트워크는 그대로 수집한다.
+     */
+    captureLogs?: LogCapture;
     /** 플로팅 버튼 위치. 모서리만 주면 여백은 기본값. */
     position?: WidgetCorner | Partial<WidgetPosition>;
     /** `internal` 판정을 프로젝트가 직접 할 때. 주면 `internalRoles` 보다 우선한다. */
@@ -672,6 +696,8 @@ interface FeedbackConfig {
     /** 경고 출구. 안 주면 `resolveConfig` 결과의 `warnings` 로만 남는다. */
     onWarn?: (warning: ConfigWarning) => void;
 }
+/** 콘솔 로그 수집 범위. 프로젝트마다 정한다. */
+type LogCapture = "problems" | "all" | "off";
 /** 기본값이 모두 채워진 설정. 위젯은 이것만 본다. */
 interface ResolvedConfig {
     token: string | null;
@@ -680,6 +706,7 @@ interface ResolvedConfig {
     visibility: Visibility;
     captureScreenshot: boolean;
     captureDiagnostics: boolean;
+    captureLogs: LogCapture;
     position: WidgetPosition;
     isInternal: VisibilityFn | null;
     internalRoles: readonly string[];
@@ -877,6 +904,11 @@ declare const MODAL_ACTION_SEND = "send";
 interface ReportModalState {
     open: boolean;
     comment: string;
+    /**
+     * 요소 지목 모드에서 고른 요소. 없으면 화면 전체에 대한 제보다.
+     * 이게 있으면 제보 종류가 `annotation` 이 되어 수집 쪽에서 지목 제보로 갈린다.
+     */
+    element: ElementInfo | null;
     priority: FeedbackPriority;
     screenshot: FeedbackScreenshot | null;
     screenshotStatus: ScreenshotStatus;
@@ -947,7 +979,9 @@ declare class ReportModalController {
     dispose(): void;
     /** WidgetController가 소유한 큐 lifecycle을 함께 정리한다. */
     stopQueue(): void;
-    open(): Promise<void>;
+    open(opts?: {
+        element?: ElementInfo | null;
+    }): Promise<void>;
     /**
      * 닫기 요청. 쓰던 내용이 있으면 곧장 닫지 않고 확인을 받는다.
      * @returns 실제로 닫혔으면 `"closed"`, 확인이 필요하면 `"confirm"`.
@@ -1024,7 +1058,14 @@ declare class WidgetController {
     get isPicking(): boolean;
     subscribe(listener: WidgetListener): () => void;
     dispose(): void;
-    openReport(): Promise<void>;
+    /**
+     * @param opts.element 요소를 지목해서 열 때 그 요소. 지목 모드에서도 화면을
+     *   `modal` 로 바꾼다 — `modal.open()` 을 직접 부르면 상태만 열리고 화면은
+     *   `picking` 에 머물러 **모달이 렌더되지 않는다**.
+     */
+    openReport(opts?: {
+        element?: ElementInfo | null;
+    }): Promise<void>;
     /** 모달 닫기 요청. 쓰던 내용이 있으면 확인부터 받는다(화면은 그대로 모달). */
     closeReport(): "closed" | "confirm";
     confirmCloseReport(): void;
@@ -1191,6 +1232,20 @@ interface LassoEnvelope {
             y: number;
         } | null;
         sourceFile: string | null;
+        /**
+         * 대시보드가 구조화 필드로 읽는 자리. 본문 마크다운에도 같은 값이 들어가지만,
+         * 거기 있는 건 사람이 읽는 용도라 화면의 뷰포트 칸이 비어 있었다(실측).
+         */
+        web: {
+            url: string | null;
+            route: string | null;
+            viewport: {
+                width: number | null;
+                height: number | null;
+                devicePixelRatio: number | null;
+            } | null;
+            userAgent: string | null;
+        } | null;
         screenshotBase64: string | null;
         screenshotContentType: "image/jpeg" | "image/png" | null;
         network: unknown[];

package/dist/index.d.ts

@@ -95,13 +95,22 @@ interface DiagNetworkEntry {
     url: string;
     /** 응답을 못 받았으면(네트워크 실패·중단) null. */
     status: number | null;
+    /**
+     * 2xx 였는가. status 로 계산할 수 있지만 따로 싣는다 —
+     * 제보를 훑는 사람이 실패한 요청만 눈으로 골라내는 게 목적이다.
+     * 응답 자체를 못 받았으면 false.
+     */
+    ok: boolean;
+    /** 네트워크 실패·중단의 사유. 성공했으면 null. 응답 본문은 담지 않는다. */
+    errorMessage: string | null;
     durationMs: number;
     /** 기록 시각(ISO 8601). */
     at: string;
 }
 /** 콘솔 기록 1건. `console.warn` / `console.error` 만 대상. */
 interface DiagLogEntry {
-    level: "warn" | "error";
+    /** `log` 은 captureLogs: "all" 일 때만 담긴다. */
+    level: "log" | "warn" | "error";
     message: string;
     at: string;
 }
@@ -517,14 +526,16 @@ declare const MAX_LOG_MESSAGE_CHARS = 2000;
 interface DiagnosticsInstallOpts {
     /** true 를 반환하면 그 요청은 기록하지 않는다(위젯 자신의 전송 등). */
     excludeMatcher?: DiagnosticsExcludeMatcher;
+    /**
+     * 콘솔 로그를 어디까지 담을지. 기본 `problems`(warn·error 만).
+     * `all` 은 log·info 까지 담는다 — 흐름 추적엔 좋지만 평범한 로그가 많은 앱에서는
+     * 그게 제보를 덮어 정작 중요한 경고가 묻힌다. 그래서 프로젝트마다 정한다.
+     */
+    logs?: "problems" | "all" | "off";
     /** 시각 주입(테스트용). */
     now?: () => number;
     iso?: (n: number) => string;
 }
-/**
- * 진단 수집기. `install()` 로 글로벌을 패치하고 `uninstall()` 로 원복한다.
- * 생성 자체는 부작용이 없다 — `install()` 을 호출해야 패치가 일어난다.
- */
 declare class DiagnosticsCollector {
     readonly network: RingBuffer<DiagNetworkEntry>;
     readonly logs: RingBuffer<DiagLogEntry>;
@@ -534,7 +545,9 @@ declare class DiagnosticsCollector {
     private originalXhrSend;
     private originalWarn;
     private originalError;
+    private originalLog;
     private excludeMatcher;
+    private logScope;
     private now;
     private iso;
     /**
@@ -568,6 +581,7 @@ declare class DiagnosticsCollector {
     snapshot(): DiagnosticsPayload;
     /** 두 버퍼를 비운다. */
     clear(): void;
+    /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
     private recordNetwork;
     private recordLog;
     private isExcluded;
@@ -661,6 +675,16 @@ interface FeedbackConfig {
     captureScreenshot?: boolean;
     /** network·logs 링버퍼를 수집할지. false 면 아예 설치하지 않는다. */
     captureDiagnostics?: boolean;
+    /**
+     * 콘솔 로그를 담을 범위. 프로젝트마다 다르다 — 로그를 정돈해 쓰는 팀에는
+     * `all` 이 가장 유용하고, 평범한 로그가 수백 줄씩 나오는 앱에서는 그게
+     * 제보를 덮어 정작 중요한 경고가 묻힌다.
+     *
+     * - `problems`(기본): warn·error 만. 노이즈 없이 문제만 남는다.
+     * - `all`: log·info 까지 전부. 개발 중 흐름 추적에 유리하다.
+     * - `off`: 로그를 담지 않는다. 네트워크는 그대로 수집한다.
+     */
+    captureLogs?: LogCapture;
     /** 플로팅 버튼 위치. 모서리만 주면 여백은 기본값. */
     position?: WidgetCorner | Partial<WidgetPosition>;
     /** `internal` 판정을 프로젝트가 직접 할 때. 주면 `internalRoles` 보다 우선한다. */
@@ -672,6 +696,8 @@ interface FeedbackConfig {
     /** 경고 출구. 안 주면 `resolveConfig` 결과의 `warnings` 로만 남는다. */
     onWarn?: (warning: ConfigWarning) => void;
 }
+/** 콘솔 로그 수집 범위. 프로젝트마다 정한다. */
+type LogCapture = "problems" | "all" | "off";
 /** 기본값이 모두 채워진 설정. 위젯은 이것만 본다. */
 interface ResolvedConfig {
     token: string | null;
@@ -680,6 +706,7 @@ interface ResolvedConfig {
     visibility: Visibility;
     captureScreenshot: boolean;
     captureDiagnostics: boolean;
+    captureLogs: LogCapture;
     position: WidgetPosition;
     isInternal: VisibilityFn | null;
     internalRoles: readonly string[];
@@ -877,6 +904,11 @@ declare const MODAL_ACTION_SEND = "send";
 interface ReportModalState {
     open: boolean;
     comment: string;
+    /**
+     * 요소 지목 모드에서 고른 요소. 없으면 화면 전체에 대한 제보다.
+     * 이게 있으면 제보 종류가 `annotation` 이 되어 수집 쪽에서 지목 제보로 갈린다.
+     */
+    element: ElementInfo | null;
     priority: FeedbackPriority;
     screenshot: FeedbackScreenshot | null;
     screenshotStatus: ScreenshotStatus;
@@ -947,7 +979,9 @@ declare class ReportModalController {
     dispose(): void;
     /** WidgetController가 소유한 큐 lifecycle을 함께 정리한다. */
     stopQueue(): void;
-    open(): Promise<void>;
+    open(opts?: {
+        element?: ElementInfo | null;
+    }): Promise<void>;
     /**
      * 닫기 요청. 쓰던 내용이 있으면 곧장 닫지 않고 확인을 받는다.
      * @returns 실제로 닫혔으면 `"closed"`, 확인이 필요하면 `"confirm"`.
@@ -1024,7 +1058,14 @@ declare class WidgetController {
     get isPicking(): boolean;
     subscribe(listener: WidgetListener): () => void;
     dispose(): void;
-    openReport(): Promise<void>;
+    /**
+     * @param opts.element 요소를 지목해서 열 때 그 요소. 지목 모드에서도 화면을
+     *   `modal` 로 바꾼다 — `modal.open()` 을 직접 부르면 상태만 열리고 화면은
+     *   `picking` 에 머물러 **모달이 렌더되지 않는다**.
+     */
+    openReport(opts?: {
+        element?: ElementInfo | null;
+    }): Promise<void>;
     /** 모달 닫기 요청. 쓰던 내용이 있으면 확인부터 받는다(화면은 그대로 모달). */
     closeReport(): "closed" | "confirm";
     confirmCloseReport(): void;
@@ -1191,6 +1232,20 @@ interface LassoEnvelope {
             y: number;
         } | null;
         sourceFile: string | null;
+        /**
+         * 대시보드가 구조화 필드로 읽는 자리. 본문 마크다운에도 같은 값이 들어가지만,
+         * 거기 있는 건 사람이 읽는 용도라 화면의 뷰포트 칸이 비어 있었다(실측).
+         */
+        web: {
+            url: string | null;
+            route: string | null;
+            viewport: {
+                width: number | null;
+                height: number | null;
+                devicePixelRatio: number | null;
+            } | null;
+            userAgent: string | null;
+        } | null;
         screenshotBase64: string | null;
         screenshotContentType: "image/jpeg" | "image/png" | null;
         network: unknown[];

package/dist/index.js

@@ -627,6 +627,10 @@ var RingBuffer = class {
 var NETWORK_BUFFER_LIMIT = 30;
 var LOG_BUFFER_LIMIT = 50;
 var MAX_LOG_MESSAGE_CHARS = 2e3;
+function failureReason(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.slice(0, 200) || "\uB124\uD2B8\uC6CC\uD06C \uC2E4\uD328";
+}
 var DiagnosticsCollector = class {
   constructor(opts = {}) {
     this.installed = false;
@@ -636,7 +640,9 @@ var DiagnosticsCollector = class {
     this.originalXhrSend = null;
     this.originalWarn = null;
     this.originalError = null;
+    this.originalLog = null;
     this.excludeMatcher = null;
+    this.logScope = "problems";
     /**
      * 패치된 fetch 안에서 동기적으로 XHR 이 열리는 깊이.
      *
@@ -669,6 +675,7 @@ var DiagnosticsCollector = class {
     if (this.installed) return;
     this.installed = true;
     this.excludeMatcher = opts.excludeMatcher ?? null;
+    this.logScope = opts.logs ?? "problems";
     if (opts.now) this.now = opts.now;
     if (opts.iso) this.iso = opts.iso;
     this.patchFetch();
@@ -694,8 +701,10 @@ var DiagnosticsCollector = class {
     const c = g.console;
     if (c && this.originalWarn) c.warn = this.originalWarn;
     if (c && this.originalError) c.error = this.originalError;
+    if (c && this.originalLog) c.log = this.originalLog;
     this.originalWarn = null;
     this.originalError = null;
+    this.originalLog = null;
     this.excludeMatcher = null;
     this.fetchDepth = 0;
   }
@@ -712,11 +721,15 @@ var DiagnosticsCollector = class {
     this.logs.clear();
   }
   // ── 내부: 기록 ────────────────────────────────────────────
-  recordNetwork(method, url, status, startedAt) {
+  /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
+  recordNetwork(method, url, status, startedAt, errorMessage = null) {
     this.network.push({
       method,
       url,
       status,
+      // 제보를 훑는 사람이 실패한 요청만 눈으로 골라낼 수 있게 따로 싣는다.
+      ok: status !== null && status >= 200 && status < 300,
+      errorMessage,
       durationMs: Math.max(0, Math.round(this.now() - startedAt)),
       at: this.iso(startedAt)
     });
@@ -753,7 +766,7 @@ var DiagnosticsCollector = class {
         pending = Promise.resolve(originalFetch(input, init));
       } catch (err) {
         self.fetchDepth -= 1;
-        if (!excluded) self.recordNetwork(method, url, null, start);
+        if (!excluded) self.recordNetwork(method, url, null, start, failureReason(err));
         throw err;
       }
       self.fetchDepth -= 1;
@@ -771,7 +784,7 @@ var DiagnosticsCollector = class {
           return raw;
         },
         (err) => {
-          if (!excluded) self.recordNetwork(method, url, null, start);
+          if (!excluded) self.recordNetwork(method, url, null, start, failureReason(err));
           throw err;
         }
       );
@@ -819,6 +832,7 @@ var DiagnosticsCollector = class {
     };
   }
   patchConsole() {
+    if (this.logScope === "off") return;
     const c = globalThis.console;
     if (!c) return;
     const self = this;
@@ -838,6 +852,14 @@ var DiagnosticsCollector = class {
         orig(...args);
       };
     }
+    if (this.logScope === "all" && typeof c.log === "function") {
+      const orig = c.log.bind(c);
+      this.originalLog = orig;
+      c.log = function patchedLog(...args) {
+        self.recordLog("log", args);
+        orig(...args);
+      };
+    }
   }
 };
 var sharedDiagnostics = new DiagnosticsCollector();
@@ -1056,6 +1078,7 @@ function resolveConfig(config = {}) {
     visibility: normalizeVisibility(config.visibility, warn),
     captureScreenshot: config.captureScreenshot ?? true,
     captureDiagnostics: config.captureDiagnostics ?? true,
+    captureLogs: config.captureLogs ?? "problems",
     position: normalizePosition(config.position, warn),
     isInternal: typeof config.isInternal === "function" ? config.isInternal : null,
     internalRoles: config.internalRoles ?? DEFAULT_INTERNAL_ROLES,
@@ -1337,6 +1360,7 @@ var ReportModalController = class {
     this.captureGeneration = 0;
     this.state = {
       open: false,
+      element: null,
       comment: "",
       priority: "unset",
       screenshot: null,
@@ -1402,7 +1426,7 @@ var ReportModalController = class {
     this.queue.stop?.();
   }
   // ── 열기/닫기 ─────────────────────────────────────────────────────────────
-  async open() {
+  async open(opts = {}) {
     if (this.state.open) return;
     const wasPending = this.state.submitStatus === "pending" && this.lastReport !== null;
     const pendingReport = wasPending ? this.lastReport : null;
@@ -1411,6 +1435,8 @@ var ReportModalController = class {
     this.patch({
       open: true,
       comment: pendingReport?.comment ?? "",
+      // 요소를 지목해서 연 경우엔 그 요소를 물고 간다. 대기 항목 복원이 우선이다.
+      element: pendingReport?.element ?? opts.element ?? null,
       priority: pendingReport?.priority ?? "unset",
       screenshot: pendingReport?.screenshot ?? null,
       screenshotStatus: "none",
@@ -1570,12 +1596,13 @@ var ReportModalController = class {
     }
     this.patch({ submitStatus: "sending", submitMessage: null });
     const parts = {
-      kind: "report",
+      // 요소를 지목했으면 지목 제보다. 수집 쪽이 이 값으로 갈린다.
+      kind: this.state.element ? "annotation" : "report",
       comment: this.state.comment,
       priority: this.state.priority,
       screenshot: this.state.screenshot,
       pin: this.state.pin,
-      element: null
+      element: this.state.element
     };
     let outcome;
     try {
@@ -1727,9 +1754,14 @@ var WidgetController = class {
     this.listeners.clear();
   }
   // ── 플로팅 버튼 ↔ 모달 ────────────────────────────────────────────────────
-  async openReport() {
+  /**
+   * @param opts.element 요소를 지목해서 열 때 그 요소. 지목 모드에서도 화면을
+   *   `modal` 로 바꾼다 — `modal.open()` 을 직접 부르면 상태만 열리고 화면은
+   *   `picking` 에 머물러 **모달이 렌더되지 않는다**.
+   */
+  async openReport(opts = {}) {
     this.screen = "modal";
-    await this.modal.open();
+    await this.modal.open(opts);
     this.emit();
   }
   /** 모달 닫기 요청. 쓰던 내용이 있으면 확인부터 받는다(화면은 그대로 모달). */
@@ -2053,6 +2085,19 @@ function parseRetryAfterMs(res) {
   const seconds = Number(raw.trim());
   return Number.isFinite(seconds) && seconds >= 0 ? Math.round(seconds * 1e3) : null;
 }
+function reasonFrom(text) {
+  try {
+    const body = JSON.parse(text);
+    const code = typeof body.code === "string" ? body.code : null;
+    const message = typeof body.message === "string" ? body.message : null;
+    const joined = [code, message].filter(Boolean).join(": ");
+    if (joined) return ` \u2014 ${joined.slice(0, 200)}`;
+  } catch {
+    const head = text.trim().slice(0, 120);
+    if (head) return ` \u2014 ${head}`;
+  }
+  return "";
+}
 function fail(retryable, extra) {
   return { ok: false, id: null, retryable, retryAfterMs: null, ...extra };
 }
@@ -2107,6 +2152,12 @@ function buildLassoEnvelope(report) {
       comment: renderReportBody(report),
       pin: report.pin ? { x: report.pin.x, y: report.pin.y } : null,
       sourceFile: el?.attributes["data-feedback-source"] ?? null,
+      web: clientType === "web" ? {
+        url: c.url,
+        route: c.screen,
+        viewport: c.web?.viewport ?? null,
+        userAgent: c.web?.userAgent ?? null
+      } : null,
       screenshotBase64: report.screenshot?.base64 ?? null,
       screenshotContentType: report.screenshot?.contentType ?? null,
       // 서버가 없으면 빈 배열로 취급하지만, 미연동과 "없었음"을 구분해 보낸다.
@@ -2162,29 +2213,38 @@ function createLassoAdapter(opts = {}) {
         return fail(true);
       }
       const status = res.status;
+      let text = "";
+      try {
+        text = await res.text();
+      } catch {
+      }
       if (status < 200 || status >= 300) {
+        const reason = reasonFrom(text);
         if (status === 429) {
-          emit("feedback-kit: \uC218\uC9D1 \uD55C\uB3C4\uC5D0 \uAC78\uB838\uB2E4(429). \uC7A0\uC2DC \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4.");
+          emit(`feedback-kit: \uC218\uC9D1 \uD55C\uB3C4\uC5D0 \uAC78\uB838\uB2E4(429). \uC7A0\uC2DC \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4.${reason}`);
           return fail(true, { retryAfterMs: parseRetryAfterMs(res), rateLimited: true });
         }
         const retryable = RETRYABLE_STATUS.has(status);
         emit(
-          `feedback-kit: \uC218\uC9D1 \uC751\uB2F5 ${status}${retryable ? " (\uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4)" : " (\uC7AC\uC2DC\uB3C4\uD558\uC9C0 \uC54A\uB294\uB2E4)"}`
+          `feedback-kit: \uC218\uC9D1 \uC751\uB2F5 ${status}${retryable ? " (\uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4)" : " (\uC7AC\uC2DC\uB3C4\uD558\uC9C0 \uC54A\uB294\uB2E4)"}${reason}`
         );
         return fail(retryable, { retryAfterMs: retryable ? parseRetryAfterMs(res) : null });
       }
       let parsed;
       try {
-        const text = await res.text();
         const value = JSON.parse(text);
         if (value === null || typeof value !== "object") throw new Error("\uAC1D\uCCB4\uAC00 \uC544\uB2D8");
         parsed = value;
       } catch {
-        emit(`feedback-kit: \uC218\uC9D1 \uC751\uB2F5 ${status} \uC758 \uBCF8\uBB38\uC744 \uC77D\uC9C0 \uBABB\uD588\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4.`);
+        emit(
+          `feedback-kit: \uC218\uC9D1 \uC751\uB2F5 ${status} \uC758 \uBCF8\uBB38\uC774 JSON \uC774 \uC544\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD55C\uB2E4.${reasonFrom(text)}`
+        );
         return fail(true);
       }
       if (parsed.ok !== true) {
-        emit(`feedback-kit: \uC218\uC9D1 \uC11C\uBC84\uAC00 \uC81C\uBCF4\uB97C \uAC70\uC808\uD588\uB2E4(${status}). \uC7AC\uC2DC\uB3C4\uD558\uC9C0 \uC54A\uB294\uB2E4.`);
+        emit(
+          `feedback-kit: \uC218\uC9D1 \uC11C\uBC84\uAC00 \uC81C\uBCF4\uB97C \uAC70\uC808\uD588\uB2E4(${status}). \uC7AC\uC2DC\uB3C4\uD558\uC9C0 \uC54A\uB294\uB2E4.${reasonFrom(text)}`
+        );
         return fail(false);
       }
       return { ok: true, id: idFrom(parsed), retryable: false, retryAfterMs: null };