@solhun/feedback-kit-core 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   TITLE_MAX_CHARS: () => TITLE_MAX_CHARS,
   WidgetController: () => WidgetController,
   buildContext: () => buildContext,
+  buildLassoContext: () => buildLassoContext,
   buildLassoEnvelope: () => buildLassoEnvelope,
   buildLinearIssue: () => buildLinearIssue,
   buildNotionPage: () => buildNotionPage,
@@ -1455,6 +1456,8 @@ var ReportModalController = class {
     this.lastReport = null;
     /** 이전 open/recapture가 늦게 끝나 최신 상태를 덮지 못하게 하는 세대 번호. */
     this.captureGeneration = 0;
+    /** 지금 들고 있는 핀의 기준. 핀이 없으면 의미 없다(기본 `picture`). */
+    this.pinAnchor = "picture";
     this.state = {
       open: false,
       element: null,
@@ -1523,12 +1526,18 @@ var ReportModalController = class {
     this.queue.stop?.();
   }
   // ── 열기/닫기 ─────────────────────────────────────────────────────────────
+  /**
+   * @param opts.pin 요소를 지목해서 열 때의 **클릭 지점**(뷰포트 기준 0~1).
+   *   여기로 받아야 뒤늦게 끝나는 자동 캡처가 좌표를 지우지 않는다 — `setPin` 으로
+   *   따로 넣으면 캡처와 경쟁해서 진다(그 경쟁에 계속 져서 좌표가 전부 유실됐다).
+   */
   async open(opts = {}) {
     if (this.state.open) return;
     const wasPending = this.state.submitStatus === "pending" && this.lastReport !== null;
     const pendingReport = wasPending ? this.lastReport : null;
     this.touched = false;
     this.submitAttempted = false;
+    this.pinAnchor = opts.pin && !pendingReport ? "viewport" : "picture";
     this.patch({
       open: true,
       comment: pendingReport?.comment ?? "",
@@ -1538,7 +1547,7 @@ var ReportModalController = class {
       screenshot: pendingReport?.screenshot ?? null,
       screenshotStatus: "none",
       screenshotMessage: null,
-      pin: pendingReport?.pin ?? null,
+      pin: pendingReport?.pin ?? opts.pin ?? null,
       submitStatus: wasPending ? "pending" : "idle",
       submitMessage: wasPending ? SUBMIT_PENDING_MESSAGE : null,
       closeConfirmVisible: false,
@@ -1587,6 +1596,7 @@ var ReportModalController = class {
     };
     this.touched = false;
     this.submitAttempted = false;
+    if (!keepDraft) this.pinAnchor = "picture";
     this.patch({
       open: false,
       closeConfirmVisible: false,
@@ -1606,11 +1616,16 @@ var ReportModalController = class {
     if (this.isDraftLocked()) return;
     this.patch({ priority });
   }
-  setPin(pin) {
+  /**
+   * @param anchor 이 좌표의 기준. 기본은 `picture`(그림 위 탭) — 앱 핀 화면이 쓰는 값이다.
+   *   웹에서 페이지를 클릭해 얻은 좌표는 `viewport` 로 넣어야 캡처에 지워지지 않는다.
+   */
+  setPin(pin, anchor = "picture") {
     if (this.isDraftLocked()) return;
+    this.pinAnchor = anchor;
     this.patch({ pin });
   }
-  /** 스크린샷 제거 — 핀은 스크린샷 위 좌표라 함께 사라진다. */
+  /** 스크린샷 제거. 그림 위에 찍은 핀은 가리킬 대상이 사라지므로 함께 버린다. */
   removeScreenshot() {
     if (this.isDraftLocked()) return;
     this.captureGeneration += 1;
@@ -1618,7 +1633,7 @@ var ReportModalController = class {
       screenshot: null,
       screenshotStatus: "none",
       screenshotMessage: null,
-      pin: null
+      ...this.pinAnchor === "picture" ? { pin: null } : {}
     });
   }
   async recapture() {
@@ -1651,15 +1666,21 @@ var ReportModalController = class {
     }
   }
   applyScreenshot(shot, failed) {
+    const dropPin = this.pinAnchor === "picture" ? { pin: null } : {};
     if (shot && !failed) {
-      this.patch({ screenshot: shot, screenshotStatus: "ready", screenshotMessage: null, pin: null });
+      this.patch({
+        screenshot: shot,
+        screenshotStatus: "ready",
+        screenshotMessage: null,
+        ...dropPin
+      });
       return;
     }
     this.patch({
       screenshot: null,
       screenshotStatus: "failed",
       screenshotMessage: SCREENSHOT_FAILED_MESSAGE,
-      pin: null
+      ...dropPin
     });
   }
   // ── 포커스 ────────────────────────────────────────────────────────────────
@@ -1855,6 +1876,8 @@ var WidgetController = class {
    * @param opts.element 요소를 지목해서 열 때 그 요소. 지목 모드에서도 화면을
    *   `modal` 로 바꾼다 — `modal.open()` 을 직접 부르면 상태만 열리고 화면은
    *   `picking` 에 머물러 **모달이 렌더되지 않는다**.
+   * @param opts.pin 지목한 클릭 지점. 열기 인자로 넘겨야 자동 캡처가 좌표를 지우지 않는다
+   *   (열고 난 뒤 `modal.setPin` 으로 넣으면 캡처와 경쟁한다).
    */
   async openReport(opts = {}) {
     this.screen = "modal";
@@ -2210,6 +2233,47 @@ function idFrom(parsed) {
   }
   return null;
 }
+function toPercent(value) {
+  return Math.round(value * 1e5) / 1e3;
+}
+function buildLassoContext(report) {
+  const c = report.context;
+  const el = report.element;
+  const user = c.user;
+  const source = el ? sourceFromElement(el) : c.source;
+  const hasSource = Boolean(source.screenId || source.sourceFile);
+  return {
+    kind: report.kind,
+    app: c.app,
+    platform: c.platform,
+    sessionId: c.sessionId,
+    clientTimestamp: c.clientTimestamp,
+    timezone: c.timezone,
+    user: user ? {
+      id: user.id,
+      name: user.name ?? null,
+      email: user.email,
+      role: user.role ?? null,
+      isGuest: user.isGuest
+    } : null,
+    source: hasSource ? {
+      screenId: source.screenId,
+      sourceFile: source.sourceFile,
+      sourceLine: source.sourceLine ?? null
+    } : null,
+    // 속성이 하나도 없으면 빈 객체를 보내지 않는다 — 화면에 빈 항목이 늘어난다.
+    element: el && (el.id !== null || Object.keys(el.attributes).length > 0) ? { id: el.id, attributes: el.attributes } : null,
+    native: c.native ? {
+      screenPath: c.native.screenPath,
+      navPath: c.native.navPath,
+      routeParams: c.native.routeParams,
+      appInfo: { ...c.native.appInfo },
+      device: { ...c.native.device },
+      display: { ...c.native.display }
+    } : null,
+    extra: c.extra
+  };
+}
 function buildLassoEnvelope(report) {
   const c = report.context;
   const clientType = c.platform === "native" ? "app" : "web";
@@ -2225,8 +2289,9 @@ function buildLassoEnvelope(report) {
     url: c.url ?? (clientType === "app" ? `app://${c.screen ?? "unknown"}` : ""),
     priority: report.priority,
     report: {
-      comment: renderReportBody(report),
-      pin: report.pin ? { x: report.pin.x, y: report.pin.y } : null,
+      // 서버가 1자 이상을 요구한다. 코멘트 없는 제보를 400 으로 잃지 않게 한 줄을 채운다.
+      comment: report.comment.trim().length > 0 ? report.comment.trim() : "(\uCF54\uBA58\uD2B8 \uC5C6\uC74C)",
+      pin: report.pin ? { x: toPercent(report.pin.x), y: toPercent(report.pin.y) } : null,
       sourceFile: el?.attributes["data-feedback-source"] ?? null,
       element: el ? {
         tag: el.tag,
@@ -2248,7 +2313,8 @@ function buildLassoEnvelope(report) {
       screenshotContentType: report.screenshot?.contentType ?? null,
       // 서버가 없으면 빈 배열로 취급하지만, 미연동과 "없었음"을 구분해 보낸다.
       network: report.context.diagnostics?.network ?? [],
-      logs: report.context.diagnostics?.logs ?? []
+      logs: report.context.diagnostics?.logs ?? [],
+      context: buildLassoContext(report)
     }
   };
 }
@@ -2383,6 +2449,7 @@ function createLassoAdapter(opts = {}) {
   TITLE_MAX_CHARS,
   WidgetController,
   buildContext,
+  buildLassoContext,
   buildLassoEnvelope,
   buildLinearIssue,
   buildNotionPage,