@bstage-sdk/bridge 0.11.0 → 0.12.0

package/README.md

@@ -210,6 +210,7 @@ external에 인증을 붙이는 fetch를 주입하지 않는다. 외부 갈래
 | `track`               | `{ name, params? }`                 | 이름 100자, params 직렬화 4KB                          |
 | `storage`             | `{ op, key, value? }`               | placement 스코프 메모리(키 50개, 값 4KB)               |
 | `log`                 | `{ level, message }`                | real phase에서는 버림                                  |
+| `report`              | `{ kind, message, frames, count }`  | 템플릿 에러 보고. 아래 "에러 보고"                   |
 
 이벤트(호스트 → 프레임, `host.send`): `slot.context`·`locale`(`{ locale, translations? }`)·`member`·`theme`·`visibility`.
 
@@ -217,6 +218,29 @@ external에 인증을 붙이는 fetch를 주입하지 않는다. 외부 갈래
 프레임 요청은 15초 안에 응답이 없으면 `TIMEOUT`. 핸드셰이크(`ready`)는 init을 받을 때까지 재전송한다(처음 10초는 250ms, 이후 2초 간격).
 프레임 → 호스트 봉투에는 최상위 `frame`(프레임 토큰)이 붙고, 문서가 내려갈 때 `evt:frame-unload`(`FRAME_UNLOAD_EVENT`)가 간다(위 "세션 수명").
 
+### 에러 보고 (`report`)
+
+격리 프레임이 잡은 템플릿 에러를 호스트로 올리는 요청이다. payload는
+`{ kind: 'error' | 'rejection' | 'load', message, frames, count }`.
+
+- 호스트는 형식을 엄격히 검사한다 — message ≤300자, frames ≤10개·각 ≤200자, count는 1~100 정수. 넘으면 잘라 받지 않고
+  `BAD_REQUEST`로 거절한다(`validateReport`).
+- **phase 게이트가 없다.** `log`(real에서 버림)와 달리 real에서도 처리한다.
+- 검증한 값은 호스트 옵션 `onTemplateReport(report)`로 넘긴다. 프레임 세션(호스트 하나)당 5건(`REPORTS_PER_SESSION`)까지만
+  부르고, 넘치는 보고는 성공으로 답하되 조용히 버린다. 콜백이 없어도 성공으로 답한다.
+- 귀속은 호스트가 한다. 프레임이 덧붙인 URL 등은 버리고 `{ kind, message, frames, count }`만 넘기므로, 임베더는 자기가
+  띄운 templateUrl로 묶는다. message·frames는 템플릿이 만든 문자열이라 텍스트로만 다루고 밖으로 보내기 전 스크러빙한다.
+
+프레임 쪽은 `createSrcdoc` 부트스트랩이 항상 수집기(`installErrorReport`)를 엔트리보다 먼저 설치한다.
+
+- 전역 `error`·`unhandledrejection`과 엔트리 script `onerror`(kind `load`, 기존 `log` 요청도 그대로 보낸다)를 잡는다.
+- message는 300자, 스택은 프레임 꼴인 줄만 10개·각 200자로 자른다. ev.error가 없으면 `filename:lineno:colno`를 쓴다.
+- fingerprint(kind + 숫자를 뺀 message + 첫 프레임)마다 한 번만 보낸다. 첫 발생 뒤 1초(`REPORT_FLUSH_DELAY_MS`) 동안
+  같은 fingerprint는 count로 묶고(100까지), 보낸 뒤의 반복은 버린다. 서로 다른 fingerprint 5건에 닿으면 리스너를 해제한다.
+- 교차 origin 번들의 에러는 브라우저가 "Script error."로 가린다. `createSrcdoc({ crossOrigin: 'anonymous' })`를 주면 엔트리
+  script에 `crossOrigin`을 둬 메시지·스택이 보인다. assetOrigin이 CORS(`Access-Control-Allow-Origin`)로 응답해야 하며,
+  아니면 엔트리 로드 자체가 실패하므로 확인한 환경에서만 켠다. 기본은 속성 없음(종전과 같은 문서).
+
 ## 프레임 문서
 
 `createSrcdoc`가 만드는 문서는 CSP로 프레임이 불러올 수 있는 것을 좁힌다. 스크립트는 nonce가 붙은
@@ -246,9 +270,9 @@ connect-src https: wss:; frame-src 'none'; form-action 'none'; base-uri 'none'
 
 ### 프레임 네트워크 (항상 적용)
 
-결정(2026-10-22): 격리 프레임에서 **토큰이 필요한 정해진 API만 브리지**로 보내고(호스트가 팬 토큰을 붙인다),
+결정(2026-10-21, 2026-10-22에 옵트인 제거): 격리 프레임에서 **토큰이 필요한 정해진 API만 브리지**로 보내고(호스트가 팬 토큰을 붙인다),
 **그 밖의 API는 템플릿이 프레임 안에서 직접** 부른다. 호스트 옵션은 없다 — `createSrcdoc`로 만든 모든 프레임(포털 미리보기 포함)이
-이 규칙으로 돈다.
+이 규칙으로 돈다. (0.3.0에서 추가한 `directNetwork` 옵트인과 `buildFrameCsp`의 4번째 인자 `FrameCspOptions`는 다음 minor에서 없앴다. 넘기던 호스트는 인자를 지우면 된다.)
 
 동작:
 

package/dist/{chunk-ND2HFYBP.js → chunk-NXB47KPE.js}

@@ -1,8 +1,9 @@
 import {
   bridgeRuntime,
   createBridgeFetch,
-  installDirectFetch
-} from "./chunk-CSAW3L7P.js";
+  installDirectFetch,
+  installErrorReport
+} from "./chunk-TPKNGW34.js";
 
 // src/protocol/envelope.ts
 var BRIDGE_VERSION = 1;
@@ -61,7 +62,8 @@ var REQUEST_TYPES = [
   "resize",
   "track",
   "storage",
-  "log"
+  "log",
+  "report"
 ];
 var HOST_EVENT_TYPES = ["slot.context", "locale", "member", "theme", "visibility"];
 var READY_EVENT = "ready";
@@ -71,6 +73,12 @@ var BRIDGE_SURFACES = ["page", "slot"];
 function isBridgeSurface(value) {
   return BRIDGE_SURFACES.includes(value);
 }
+var TEMPLATE_REPORT_KINDS = ["error", "rejection", "load"];
+var REPORT_MESSAGE_MAX_LENGTH = 300;
+var REPORT_MAX_FRAMES = 10;
+var REPORT_FRAME_MAX_LENGTH = 200;
+var REPORT_COUNT_MAX = 100;
+var REPORTS_PER_SESSION = 5;
 var IFRAME_ATTRIBUTES = {
   sandbox: "allow-scripts",
   allow: "autoplay; fullscreen; picture-in-picture; encrypted-media; clipboard-write",
@@ -402,6 +410,7 @@ function toScriptLiteral(value) {
 
 // src/srcdoc/createSrcdoc.ts
 var MAX_MEDIA_ORIGINS = 20;
+var REPORT_FLUSH_DELAY_MS = 1e3;
 var MAX_ELEMENT_NAME_LENGTH = 100;
 var ELEMENT_NAME_RE = /^[a-z][a-z0-9._]*-[a-z0-9._-]*$/;
 function isValidElementName(value) {
@@ -470,6 +479,16 @@ function bootstrapScript(o) {
     // 라우터는 항상 심는다. ready.then이 엔트리 로드(아래 client.ready.then)보다 먼저 등록돼야 템플릿보다 먼저 스냅샷을 잡는다.
     `var installDirectFetch = ${installDirectFetch.toString()};`,
     "installDirectFetch(globalThis, client, { hostOrigin: HOST_ORIGIN });",
+    // 에러 수집기는 엔트리(템플릿)보다 먼저 리스너를 건다. 상한은 호스트 검증기와 같은 프로토콜 값이다.
+    `var installErrorReport = ${installErrorReport.toString()};`,
+    "var reportError = installErrorReport(globalThis, client, {",
+    `  maxReports: ${REPORTS_PER_SESSION},`,
+    `  maxMessageLength: ${REPORT_MESSAGE_MAX_LENGTH},`,
+    `  maxFrames: ${REPORT_MAX_FRAMES},`,
+    `  maxFrameLength: ${REPORT_FRAME_MAX_LENGTH},`,
+    `  maxCount: ${REPORT_COUNT_MAX},`,
+    `  flushDelayMs: ${REPORT_FLUSH_DELAY_MS}`,
+    "});",
     "var lastHeight = -1;",
     "var scheduled = false;",
     "function reportHeight() {",
@@ -486,9 +505,12 @@ function bootstrapScript(o) {
     "}",
     "client.ready.then(function () {",
     "  var script = document.createElement('script');",
+    // crossOrigin은 src보다 먼저 둔다(요청 모드가 src 대입 시점에 정해지는 브라우저가 있다). 주지 않으면 줄 자체가 없다.
+    ...o.crossOrigin === "anonymous" ? ["  script.crossOrigin = 'anonymous';"] : [],
     "  script.src = ENTRY_URL;",
     "  script.onerror = function () {",
     "    client.request('log', { level: 'error', message: 'template entry failed to load' }).catch(function () {});",
+    "    reportError('load', 'template entry failed to load', '');",
     "  };",
     "  document.head.appendChild(script);",
     "  customElements.whenDefined(ELEMENT_NAME).then(function () {",
@@ -514,8 +536,12 @@ function createSrcdoc(options) {
   }
   if (typeof title !== "string") throw new TypeError("[bstage-bridge] title\uC740 \uBB38\uC790\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4");
   const mediaOrigins = normalizeMediaOrigins(options.mediaOrigins);
+  const { crossOrigin } = options;
+  if (crossOrigin !== void 0 && crossOrigin !== "anonymous") {
+    throw new TypeError("[bstage-bridge] crossOrigin\uC740 'anonymous'\uB9CC \uBC1B\uC2B5\uB2C8\uB2E4");
+  }
   const csp = buildFrameCsp(nonce, assetOrigin, mediaOrigins);
-  const script = bootstrapScript({ session, hostOrigin, entryUrl, elementName });
+  const script = bootstrapScript({ session, hostOrigin, entryUrl, elementName, crossOrigin });
   if (/<\/script|<!--/i.test(script)) {
     throw new Error("[bstage-bridge] \uBD80\uD2B8\uC2A4\uD2B8\uB7A9 \uC2A4\uD06C\uB9BD\uD2B8\uC5D0 \uC2A4\uD06C\uB9BD\uD2B8 \uC885\uB8CC \uC2DC\uD000\uC2A4\uAC00 \uC788\uC2B5\uB2C8\uB2E4");
   }
@@ -559,6 +585,12 @@ export {
   FRAME_UNLOAD_EVENT,
   BRIDGE_SURFACES,
   isBridgeSurface,
+  TEMPLATE_REPORT_KINDS,
+  REPORT_MESSAGE_MAX_LENGTH,
+  REPORT_MAX_FRAMES,
+  REPORT_FRAME_MAX_LENGTH,
+  REPORT_COUNT_MAX,
+  REPORTS_PER_SESSION,
   IFRAME_ATTRIBUTES,
   isRequestType,
   isHostEventType,
@@ -583,6 +615,7 @@ export {
   normalizePinnedHeaders,
   prepareFetch,
   MAX_MEDIA_ORIGINS,
+  REPORT_FLUSH_DELAY_MS,
   MAX_ELEMENT_NAME_LENGTH,
   buildFrameCsp,
   createSrcdoc

package/dist/{chunk-CSAW3L7P.js → chunk-TPKNGW34.js}

@@ -210,6 +210,112 @@ function installDirectFetch(g, client, config) {
   return bstageFetch;
 }
 
+// src/frame/errorReport.ts
+function installErrorReport(g, client, config) {
+  const schedule = typeof g.setTimeout === "function" ? g.setTimeout : void 0;
+  const entries = /* @__PURE__ */ new Map();
+  let admitted = 0;
+  function toText(value) {
+    if (typeof value === "string") return value;
+    try {
+      return String(value);
+    } catch {
+      return "";
+    }
+  }
+  function framesOf(stack) {
+    const out = [];
+    if (typeof stack !== "string") return out;
+    const lines = stack.split("\n");
+    for (let i = 0; i < lines.length && out.length < config.maxFrames; i += 1) {
+      const line = lines[i].trim();
+      if (/^at\s/.test(line) || /^[^@]*@(?:[a-z][\w+.-]*:\/\/|\/)\S*:\d+:\d+$/i.test(line) || /^(?:[a-z][\w+.-]*:\/\/|\/)\S*:\d+:\d+$/i.test(line))
+        out.push(line.slice(0, config.maxFrameLength));
+    }
+    return out;
+  }
+  function send(key) {
+    const entry = entries.get(key);
+    if (!entry || entry.sent) return;
+    entries.set(key, {
+      kind: entry.kind,
+      message: entry.message,
+      frames: entry.frames,
+      count: entry.count,
+      sent: true
+    });
+    try {
+      client.request("report", {
+        kind: entry.kind,
+        message: entry.message,
+        frames: entry.frames,
+        count: entry.count
+      }).catch(function() {
+      });
+    } catch {
+    }
+  }
+  function record(kind, message, stack) {
+    try {
+      const text = toText(message).slice(0, config.maxMessageLength);
+      const frames = framesOf(stack);
+      const key = kind + "|" + text.replace(/\d+/g, "") + "|" + (frames[0] || "");
+      const entry = entries.get(key);
+      if (entry) {
+        if (!entry.sent && entry.count < config.maxCount) {
+          entries.set(key, {
+            kind: entry.kind,
+            message: entry.message,
+            frames: entry.frames,
+            count: entry.count + 1,
+            sent: false
+          });
+        }
+        return;
+      }
+      if (admitted >= config.maxReports) return;
+      admitted += 1;
+      entries.set(key, { kind, message: text, frames, count: 1, sent: false });
+      if (admitted >= config.maxReports) stop();
+      if (schedule) {
+        schedule(function() {
+          send(key);
+        }, config.flushDelayMs);
+      } else {
+        send(key);
+      }
+    } catch {
+    }
+  }
+  function onError(ev) {
+    const err = ev && ev.error;
+    if (err && typeof err === "object") {
+      record("error", typeof err.message === "string" ? err.message : ev.message, err.stack);
+      return;
+    }
+    const where = ev && typeof ev.filename === "string" && ev.filename !== "" ? "at " + ev.filename + ":" + toText(ev.lineno) + ":" + toText(ev.colno) : "";
+    record("error", ev ? ev.message : "", where);
+  }
+  function onRejection(ev) {
+    const reason = ev ? ev.reason : void 0;
+    if (reason && typeof reason === "object" && typeof reason.message === "string") {
+      record("rejection", reason.message, reason.stack);
+      return;
+    }
+    record("rejection", reason, "");
+  }
+  function stop() {
+    if (typeof g.removeEventListener !== "function") return;
+    g.removeEventListener("error", onError);
+    g.removeEventListener("unhandledrejection", onRejection);
+  }
+  if (typeof g.addEventListener === "function") {
+    g.addEventListener("error", onError);
+    g.addEventListener("unhandledrejection", onRejection);
+  }
+  return record;
+}
+
 // src/frame/runtime.ts
 function bridgeRuntime(g, makeFetch, config) {
   const NS = "bstage-bridge";
@@ -463,5 +569,6 @@ function bridgeRuntime(g, makeFetch, config) {
 export {
   bridgeRuntime,
   createBridgeFetch,
-  installDirectFetch
+  installDirectFetch,
+  installErrorReport
 };

package/dist/{createSrcdoc-DgQyvIjG.d.cts → createSrcdoc-DYZk6dDJ.d.cts}

@@ -25,9 +25,20 @@ interface CreateSrcdocOptions {
      * CSP img-src·media-src에만 더해진다. 잘못된 항목이 하나라도 있으면 TypeError.
      */
     readonly mediaOrigins?: readonly string[];
+    /**
+     * 엔트리 script의 `crossOrigin`. `'anonymous'`만 받는다(그 밖의 값은 TypeError). 주면 교차 origin 번들의
+     * 에러가 "Script error."로 가려지지 않고 메시지·스택이 보인다 — 대신 assetOrigin이 CORS
+     * (`Access-Control-Allow-Origin`)로 응답해야 하며, 아니면 엔트리 로드 자체가 실패한다. 기본은 속성 없음.
+     */
+    readonly crossOrigin?: 'anonymous';
 }
 /** mediaOrigins 최대 개수. */
 declare const MAX_MEDIA_ORIGINS = 20;
+/**
+ * 에러 보고 묶음 대기(ms) — 첫 발생 뒤 이만큼 기다리며 같은 fingerprint를 count로 묶어 한 번 보낸다.
+ * 프로토콜에 정해지지 않은 값(구현 선택).
+ */
+declare const REPORT_FLUSH_DELAY_MS = 1000;
 /** elementName 최대 길이. 정규식 앞에서 먼저 잘라 입력 크기를 고정한다. */
 declare const MAX_ELEMENT_NAME_LENGTH = 100;
 /**
@@ -48,8 +59,8 @@ declare function buildFrameCsp(nonce: string, assetOrigin: string, mediaOrigins?
  *
  * iframe 속성은 `IFRAME_ATTRIBUTES`(sandbox="allow-scripts" 등)를 쓴다.
  *
- * @throws TypeError 입력이 형식에 맞지 않을 때(잘못된 nonce·세션·origin·엔트리·요소 이름·mediaOrigins)
+ * @throws TypeError 입력이 형식에 맞지 않을 때(잘못된 nonce·세션·origin·엔트리·요소 이름·mediaOrigins·crossOrigin)
  */
 declare function createSrcdoc(options: CreateSrcdocOptions): string;
 
-export { type CreateSrcdocOptions as C, MAX_ELEMENT_NAME_LENGTH as M, MAX_MEDIA_ORIGINS as a, buildFrameCsp as b, createNonce as c, createSession as d, createSrcdoc as e, isValidSession as f, isValidNonce as i };
+export { type CreateSrcdocOptions as C, MAX_ELEMENT_NAME_LENGTH as M, REPORT_FLUSH_DELAY_MS as R, MAX_MEDIA_ORIGINS as a, buildFrameCsp as b, createNonce as c, createSession as d, createSrcdoc as e, isValidSession as f, isValidNonce as i };

package/dist/{createSrcdoc-DgQyvIjG.d.ts → createSrcdoc-DYZk6dDJ.d.ts}

@@ -25,9 +25,20 @@ interface CreateSrcdocOptions {
      * CSP img-src·media-src에만 더해진다. 잘못된 항목이 하나라도 있으면 TypeError.
      */
     readonly mediaOrigins?: readonly string[];
+    /**
+     * 엔트리 script의 `crossOrigin`. `'anonymous'`만 받는다(그 밖의 값은 TypeError). 주면 교차 origin 번들의
+     * 에러가 "Script error."로 가려지지 않고 메시지·스택이 보인다 — 대신 assetOrigin이 CORS
+     * (`Access-Control-Allow-Origin`)로 응답해야 하며, 아니면 엔트리 로드 자체가 실패한다. 기본은 속성 없음.
+     */
+    readonly crossOrigin?: 'anonymous';
 }
 /** mediaOrigins 최대 개수. */
 declare const MAX_MEDIA_ORIGINS = 20;
+/**
+ * 에러 보고 묶음 대기(ms) — 첫 발생 뒤 이만큼 기다리며 같은 fingerprint를 count로 묶어 한 번 보낸다.
+ * 프로토콜에 정해지지 않은 값(구현 선택).
+ */
+declare const REPORT_FLUSH_DELAY_MS = 1000;
 /** elementName 최대 길이. 정규식 앞에서 먼저 잘라 입력 크기를 고정한다. */
 declare const MAX_ELEMENT_NAME_LENGTH = 100;
 /**
@@ -48,8 +59,8 @@ declare function buildFrameCsp(nonce: string, assetOrigin: string, mediaOrigins?
  *
  * iframe 속성은 `IFRAME_ATTRIBUTES`(sandbox="allow-scripts" 등)를 쓴다.
  *
- * @throws TypeError 입력이 형식에 맞지 않을 때(잘못된 nonce·세션·origin·엔트리·요소 이름·mediaOrigins)
+ * @throws TypeError 입력이 형식에 맞지 않을 때(잘못된 nonce·세션·origin·엔트리·요소 이름·mediaOrigins·crossOrigin)
  */
 declare function createSrcdoc(options: CreateSrcdocOptions): string;
 
-export { type CreateSrcdocOptions as C, MAX_ELEMENT_NAME_LENGTH as M, MAX_MEDIA_ORIGINS as a, buildFrameCsp as b, createNonce as c, createSession as d, createSrcdoc as e, isValidSession as f, isValidNonce as i };
+export { type CreateSrcdocOptions as C, MAX_ELEMENT_NAME_LENGTH as M, REPORT_FLUSH_DELAY_MS as R, MAX_MEDIA_ORIGINS as a, buildFrameCsp as b, createNonce as c, createSession as d, createSrcdoc as e, isValidSession as f, isValidNonce as i };

package/dist/frame.cjs

@@ -22,7 +22,8 @@ var frame_exports = {};
 __export(frame_exports, {
   createBridgeClient: () => createBridgeClient,
   createBridgeFetch: () => createBridgeFetch,
-  installDirectFetch: () => installDirectFetch
+  installDirectFetch: () => installDirectFetch,
+  installErrorReport: () => installErrorReport
 });
 module.exports = __toCommonJS(frame_exports);
 
@@ -500,9 +501,116 @@ function installDirectFetch(g, client, config) {
   });
   return bstageFetch;
 }
+
+// src/frame/errorReport.ts
+function installErrorReport(g, client, config) {
+  const schedule = typeof g.setTimeout === "function" ? g.setTimeout : void 0;
+  const entries = /* @__PURE__ */ new Map();
+  let admitted = 0;
+  function toText(value) {
+    if (typeof value === "string") return value;
+    try {
+      return String(value);
+    } catch {
+      return "";
+    }
+  }
+  function framesOf(stack) {
+    const out = [];
+    if (typeof stack !== "string") return out;
+    const lines = stack.split("\n");
+    for (let i = 0; i < lines.length && out.length < config.maxFrames; i += 1) {
+      const line = lines[i].trim();
+      if (/^at\s/.test(line) || /^[^@]*@(?:[a-z][\w+.-]*:\/\/|\/)\S*:\d+:\d+$/i.test(line) || /^(?:[a-z][\w+.-]*:\/\/|\/)\S*:\d+:\d+$/i.test(line))
+        out.push(line.slice(0, config.maxFrameLength));
+    }
+    return out;
+  }
+  function send(key) {
+    const entry = entries.get(key);
+    if (!entry || entry.sent) return;
+    entries.set(key, {
+      kind: entry.kind,
+      message: entry.message,
+      frames: entry.frames,
+      count: entry.count,
+      sent: true
+    });
+    try {
+      client.request("report", {
+        kind: entry.kind,
+        message: entry.message,
+        frames: entry.frames,
+        count: entry.count
+      }).catch(function() {
+      });
+    } catch {
+    }
+  }
+  function record(kind, message, stack) {
+    try {
+      const text = toText(message).slice(0, config.maxMessageLength);
+      const frames = framesOf(stack);
+      const key = kind + "|" + text.replace(/\d+/g, "") + "|" + (frames[0] || "");
+      const entry = entries.get(key);
+      if (entry) {
+        if (!entry.sent && entry.count < config.maxCount) {
+          entries.set(key, {
+            kind: entry.kind,
+            message: entry.message,
+            frames: entry.frames,
+            count: entry.count + 1,
+            sent: false
+          });
+        }
+        return;
+      }
+      if (admitted >= config.maxReports) return;
+      admitted += 1;
+      entries.set(key, { kind, message: text, frames, count: 1, sent: false });
+      if (admitted >= config.maxReports) stop();
+      if (schedule) {
+        schedule(function() {
+          send(key);
+        }, config.flushDelayMs);
+      } else {
+        send(key);
+      }
+    } catch {
+    }
+  }
+  function onError(ev) {
+    const err = ev && ev.error;
+    if (err && typeof err === "object") {
+      record("error", typeof err.message === "string" ? err.message : ev.message, err.stack);
+      return;
+    }
+    const where = ev && typeof ev.filename === "string" && ev.filename !== "" ? "at " + ev.filename + ":" + toText(ev.lineno) + ":" + toText(ev.colno) : "";
+    record("error", ev ? ev.message : "", where);
+  }
+  function onRejection(ev) {
+    const reason = ev ? ev.reason : void 0;
+    if (reason && typeof reason === "object" && typeof reason.message === "string") {
+      record("rejection", reason.message, reason.stack);
+      return;
+    }
+    record("rejection", reason, "");
+  }
+  function stop() {
+    if (typeof g.removeEventListener !== "function") return;
+    g.removeEventListener("error", onError);
+    g.removeEventListener("unhandledrejection", onRejection);
+  }
+  if (typeof g.addEventListener === "function") {
+    g.addEventListener("error", onError);
+    g.addEventListener("unhandledrejection", onRejection);
+  }
+  return record;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createBridgeClient,
   createBridgeFetch,
-  installDirectFetch
+  installDirectFetch,
+  installErrorReport
 });

package/dist/frame.d.cts

@@ -1,4 +1,4 @@
-import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-BjpZyiLy.cjs';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap, z as TemplateReportKind } from './messages-Cdjpvu2S.cjs';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -114,4 +114,48 @@ type DirectRoute = 'bridge' | 'direct' | 'reject';
  */
 declare function installDirectFetch(g: DirectFetchGlobal, client: Pick<BridgeClient, 'fetch' | 'ready'>, config: DirectFetchConfig): typeof globalThis.fetch;
 
-export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch };
+/** `installErrorReport` 설정 — srcdoc 부트스트랩이 프로토콜 상한을 상수로 넘긴다. */
+interface ErrorReportConfig {
+    /** 세션당 서로 다른 fingerprint 상한. 닿으면 리스너를 해제한다. */
+    readonly maxReports: number;
+    readonly maxMessageLength: number;
+    readonly maxFrames: number;
+    readonly maxFrameLength: number;
+    /** 같은 fingerprint 누적 횟수 상한. */
+    readonly maxCount: number;
+    /** 첫 발생 뒤 보내기까지 기다리는 시간(ms). 그 사이 같은 fingerprint는 count로 묶인다. */
+    readonly flushDelayMs: number;
+}
+/** 수집기가 쓰는 전역의 최소 모양 — 테스트에서 가짜 창을 넘길 수 있게 한다. */
+interface ErrorReportGlobal {
+    addEventListener?(type: 'error' | 'unhandledrejection', fn: (ev: never) => void): void;
+    removeEventListener?(type: 'error' | 'unhandledrejection', fn: (ev: never) => void): void;
+    setTimeout?: (fn: () => void, ms: number) => unknown;
+}
+/** 수집기에 직접 넣는 함수 — 엔트리 스크립트 load 실패처럼 이벤트가 아닌 것을 보고할 때 쓴다. */
+type ErrorReportRecord = (kind: TemplateReportKind, message: unknown, stack: unknown) => void;
+/**
+ * 격리 프레임의 템플릿 에러 수집기를 설치한다(`createSrcdoc` 부트스트랩이 항상 설치한다).
+ *
+ * - 전역 `error`·`unhandledrejection`을 듣고, 반환 함수로 엔트리 load 실패(kind `load`)도 받는다.
+ * - 정규화: message는 문자열로 바꿔 `maxMessageLength`에서 자르고, 스택은 줄로 나눠 프레임 꼴(`at …`·`f@url`·
+ *   `…:줄:열`)인 줄만 `maxFrames`개·각 `maxFrameLength`자로 남긴다. ev.error가 없으면(교차 origin "Script error." 등)
+ *   ev.message와 `filename:lineno:colno`를 쓴다.
+ * - fingerprint(kind + 숫자를 뺀 message + 첫 프레임)마다 한 번만 보낸다. 첫 발생 뒤 `flushDelayMs` 동안 같은
+ *   fingerprint는 count로 묶고(`maxCount`까지), 보낸 뒤의 반복은 버린다.
+ * - 서로 다른 fingerprint는 세션당 `maxReports`건까지. 닿으면 리스너를 해제한다.
+ *
+ * URL·placement는 싣지 않는다 — 귀속은 호스트가 자기가 띄운 템플릿으로 한다. 보내기 실패는 삼킨다.
+ *
+ * **자기완결 함수다** — `bridgeRuntime`과 함께 srcdoc에 `toString()`으로 심긴다(runtime.ts 주석 참고).
+ * 템플릿 코드보다 먼저 돌며 `setTimeout`을 이때 잡아 둔다. 템플릿이 다른 전역을 바꿔 보고가 틀어져도
+ * 호스트가 형식을 다시 검사하므로(`validateReport`) 이 수집기는 신뢰 경계가 아니다.
+ *
+ * @param g 프레임 전역(`globalThis`)
+ * @param client 프레임 브리지 클라이언트(`bridgeRuntime` 결과)
+ * @param config 프로토콜 상한과 묶음 대기 시간
+ * @returns 이벤트 밖의 에러를 넣는 함수
+ */
+declare function installErrorReport(g: ErrorReportGlobal, client: Pick<BridgeClient, 'request'>, config: ErrorReportConfig): ErrorReportRecord;
+
+export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type ErrorReportConfig, type ErrorReportGlobal, type ErrorReportRecord, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch, installErrorReport };

package/dist/frame.d.ts

@@ -1,4 +1,4 @@
-import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-BjpZyiLy.js';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap, z as TemplateReportKind } from './messages-Cdjpvu2S.js';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -114,4 +114,48 @@ type DirectRoute = 'bridge' | 'direct' | 'reject';
  */
 declare function installDirectFetch(g: DirectFetchGlobal, client: Pick<BridgeClient, 'fetch' | 'ready'>, config: DirectFetchConfig): typeof globalThis.fetch;
 
-export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch };
+/** `installErrorReport` 설정 — srcdoc 부트스트랩이 프로토콜 상한을 상수로 넘긴다. */
+interface ErrorReportConfig {
+    /** 세션당 서로 다른 fingerprint 상한. 닿으면 리스너를 해제한다. */
+    readonly maxReports: number;
+    readonly maxMessageLength: number;
+    readonly maxFrames: number;
+    readonly maxFrameLength: number;
+    /** 같은 fingerprint 누적 횟수 상한. */
+    readonly maxCount: number;
+    /** 첫 발생 뒤 보내기까지 기다리는 시간(ms). 그 사이 같은 fingerprint는 count로 묶인다. */
+    readonly flushDelayMs: number;
+}
+/** 수집기가 쓰는 전역의 최소 모양 — 테스트에서 가짜 창을 넘길 수 있게 한다. */
+interface ErrorReportGlobal {
+    addEventListener?(type: 'error' | 'unhandledrejection', fn: (ev: never) => void): void;
+    removeEventListener?(type: 'error' | 'unhandledrejection', fn: (ev: never) => void): void;
+    setTimeout?: (fn: () => void, ms: number) => unknown;
+}
+/** 수집기에 직접 넣는 함수 — 엔트리 스크립트 load 실패처럼 이벤트가 아닌 것을 보고할 때 쓴다. */
+type ErrorReportRecord = (kind: TemplateReportKind, message: unknown, stack: unknown) => void;
+/**
+ * 격리 프레임의 템플릿 에러 수집기를 설치한다(`createSrcdoc` 부트스트랩이 항상 설치한다).
+ *
+ * - 전역 `error`·`unhandledrejection`을 듣고, 반환 함수로 엔트리 load 실패(kind `load`)도 받는다.
+ * - 정규화: message는 문자열로 바꿔 `maxMessageLength`에서 자르고, 스택은 줄로 나눠 프레임 꼴(`at …`·`f@url`·
+ *   `…:줄:열`)인 줄만 `maxFrames`개·각 `maxFrameLength`자로 남긴다. ev.error가 없으면(교차 origin "Script error." 등)
+ *   ev.message와 `filename:lineno:colno`를 쓴다.
+ * - fingerprint(kind + 숫자를 뺀 message + 첫 프레임)마다 한 번만 보낸다. 첫 발생 뒤 `flushDelayMs` 동안 같은
+ *   fingerprint는 count로 묶고(`maxCount`까지), 보낸 뒤의 반복은 버린다.
+ * - 서로 다른 fingerprint는 세션당 `maxReports`건까지. 닿으면 리스너를 해제한다.
+ *
+ * URL·placement는 싣지 않는다 — 귀속은 호스트가 자기가 띄운 템플릿으로 한다. 보내기 실패는 삼킨다.
+ *
+ * **자기완결 함수다** — `bridgeRuntime`과 함께 srcdoc에 `toString()`으로 심긴다(runtime.ts 주석 참고).
+ * 템플릿 코드보다 먼저 돌며 `setTimeout`을 이때 잡아 둔다. 템플릿이 다른 전역을 바꿔 보고가 틀어져도
+ * 호스트가 형식을 다시 검사하므로(`validateReport`) 이 수집기는 신뢰 경계가 아니다.
+ *
+ * @param g 프레임 전역(`globalThis`)
+ * @param client 프레임 브리지 클라이언트(`bridgeRuntime` 결과)
+ * @param config 프로토콜 상한과 묶음 대기 시간
+ * @returns 이벤트 밖의 에러를 넣는 함수
+ */
+declare function installErrorReport(g: ErrorReportGlobal, client: Pick<BridgeClient, 'request'>, config: ErrorReportConfig): ErrorReportRecord;
+
+export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type ErrorReportConfig, type ErrorReportGlobal, type ErrorReportRecord, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch, installErrorReport };

package/dist/frame.js

@@ -1,8 +1,9 @@
 import {
   bridgeRuntime,
   createBridgeFetch,
-  installDirectFetch
-} from "./chunk-CSAW3L7P.js";
+  installDirectFetch,
+  installErrorReport
+} from "./chunk-TPKNGW34.js";
 
 // src/frame/createBridgeClient.ts
 var BRIDGE_CONFIG_GLOBAL = "__bstage_bridge_config__";
@@ -19,5 +20,6 @@ function createBridgeClient(options = {}) {
 export {
   createBridgeClient,
   createBridgeFetch,
-  installDirectFetch
+  installDirectFetch,
+  installErrorReport
 };