@bstage-sdk/bridge 0.10.0 → 0.12.0

package/dist/frame.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var frame_exports = {};
 __export(frame_exports, {
   createBridgeClient: () => createBridgeClient,
-  createBridgeFetch: () => createBridgeFetch
+  createBridgeFetch: () => createBridgeFetch,
+  installDirectFetch: () => installDirectFetch,
+  installErrorReport: () => installErrorReport
 });
 module.exports = __toCommonJS(frame_exports);
 
@@ -379,8 +381,236 @@ function createBridgeClient(options = {}) {
   }
   return bridgeRuntime(g, createBridgeFetch, { session, hostOrigin });
 }
+
+// src/frame/directFetch.ts
+function installDirectFetch(g, client, config) {
+  const hostOrigin = config.hostOrigin;
+  const callFn = Function.prototype.call;
+  const NativeURL = g.URL;
+  const rawFetch = g.fetch;
+  const nativeFetch = typeof rawFetch === "function" ? callFn.bind(rawFetch) : void 0;
+  const bridgeFetch = client.fetch;
+  const strSlice = callFn.bind(String.prototype.slice);
+  const promiseThen = callFn.bind(Promise.prototype.then);
+  const promiseReject = Promise.reject.bind(Promise);
+  const assign = Object.assign;
+  const TypeErr = TypeError;
+  function getter(ctor, name) {
+    if (typeof ctor !== "function") return void 0;
+    let proto = ctor.prototype;
+    while (proto) {
+      const desc = Object.getOwnPropertyDescriptor(proto, name);
+      if (desc && typeof desc.get === "function") {
+        return callFn.bind(desc.get);
+      }
+      proto = Object.getPrototypeOf(proto);
+    }
+    return void 0;
+  }
+  const getHref = getter(NativeURL, "href");
+  const getOrigin = getter(NativeURL, "origin");
+  const getProtocol = getter(NativeURL, "protocol");
+  const getPathname = getter(NativeURL, "pathname");
+  const getRequestUrl = getter(g.Request, "url");
+  let gatewayPrefixes = null;
+  let partnerOrigins = [];
+  let routesReady = false;
+  function copyStrings(value) {
+    if (!Array.isArray(value)) return null;
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+      if (typeof value[i] === "string") out[out.length] = value[i];
+    }
+    return out;
+  }
+  function takeSnapshot(init) {
+    if (routesReady) return;
+    const raw = init;
+    gatewayPrefixes = copyStrings(raw.gatewayPrefixes);
+    partnerOrigins = copyStrings(raw.partnerOrigins) || [];
+    routesReady = true;
+  }
+  promiseThen(client.ready, takeSnapshot);
+  function matchesPrefix(pathname, prefix) {
+    const bare = strSlice(prefix, prefix.length - 1) === "/" ? strSlice(prefix, 0, -1) : prefix;
+    return pathname === bare || strSlice(pathname, 0, bare.length + 1) === bare + "/";
+  }
+  function routeOf(origin, protocol, pathname) {
+    if (origin === hostOrigin) {
+      if (gatewayPrefixes === null) return "bridge";
+      for (let i = 0; i < gatewayPrefixes.length; i += 1) {
+        if (matchesPrefix(pathname, gatewayPrefixes[i])) return "bridge";
+      }
+      return "reject";
+    }
+    for (let i = 0; i < partnerOrigins.length; i += 1) {
+      if (origin === partnerOrigins[i]) return "bridge";
+    }
+    return protocol === "https:" ? "direct" : "reject";
+  }
+  function requestUrlOf(input) {
+    if (!getRequestUrl || typeof input !== "object" || input === null) return void 0;
+    try {
+      return getRequestUrl(input);
+    } catch {
+      return void 0;
+    }
+  }
+  function dispatch(input, init) {
+    if (typeof NativeURL !== "function" || !getHref || !getOrigin || !getProtocol || !getPathname) {
+      return promiseReject(new TypeErr("bstage fetch: URL is unavailable"));
+    }
+    const requestUrl = requestUrlOf(input);
+    const request = requestUrl !== void 0;
+    let parsed;
+    try {
+      parsed = new NativeURL(request ? requestUrl : String(input), hostOrigin);
+    } catch {
+      return promiseReject(new TypeErr("bstage fetch: invalid url"));
+    }
+    const href = getHref(parsed);
+    const route = routeOf(getOrigin(parsed), getProtocol(parsed), getPathname(parsed));
+    const target = request ? input : href;
+    if (route === "bridge") return bridgeFetch(target, init);
+    if (route === "reject") {
+      return promiseReject(new TypeErr("bstage fetch: destination not allowed"));
+    }
+    if (!nativeFetch) return promiseReject(new TypeErr("bstage fetch: fetch is unavailable"));
+    return nativeFetch(
+      g,
+      target,
+      assign({}, init, { credentials: "omit", referrerPolicy: "no-referrer" })
+    );
+  }
+  function bstageFetch(input, init) {
+    try {
+      if (routesReady) return dispatch(input, init);
+      return promiseThen(client.ready, function(value) {
+        takeSnapshot(value);
+        return dispatch(input, init);
+      });
+    } catch {
+      return promiseReject(new TypeErr("bstage fetch: request failed"));
+    }
+  }
+  Object.defineProperty(g, "__bstage_fetch__", {
+    value: bstageFetch,
+    writable: false,
+    configurable: false,
+    enumerable: false
+  });
+  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
+  createBridgeFetch,
+  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-CRGnyf-6.cjs';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap, z as TemplateReportKind } from './messages-Cdjpvu2S.cjs';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -73,4 +73,89 @@ declare function createBridgeClient(options?: CreateBridgeClientOptions): Bridge
  */
 declare function createBridgeFetch(client: BridgeRequester): typeof globalThis.fetch;
 
-export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type Unsubscribe, createBridgeClient, createBridgeFetch };
+/** `installDirectFetch` 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
+interface DirectFetchConfig {
+    /** 호스트 페이지 origin(srcdoc에 심긴 값). 상대 URL의 기준이자 "같은 origin" 판정 기준. */
+    readonly hostOrigin: string;
+}
+/** 프레임 fetch 라우터가 쓰는 전역의 최소 모양 — 테스트에서 가짜 창을 넘길 수 있게 한다. */
+interface DirectFetchGlobal {
+    fetch?: typeof globalThis.fetch;
+    URL?: typeof URL;
+    Request?: typeof Request;
+    __bstage_fetch__?: typeof globalThis.fetch;
+}
+/** 갈래 판정 결과. */
+type DirectRoute = 'bridge' | 'direct' | 'reject';
+/**
+ * 격리 프레임의 fetch 라우터를(`createSrcdoc` 부트스트랩이 항상 설치한다, README "프레임 네트워크")
+ * `globalThis.__bstage_fetch__`에 설치한다. inline 모드용으로 쓰인 템플릿이 부르는 그 이름이다.
+ *
+ * 갈래(`new URL(input, hostOrigin)`으로 정규화한 뒤):
+ * - **브리지**(토큰이 필요한 목적지): hostOrigin과 같은 origin이고 경로가 init `gatewayPrefixes` 안, 또는
+ *   origin이 init `partnerOrigins`와 정확히 일치. 기존 브리지 fetch(`client.fetch`)로 보내고 호스트가 다시 판정한다.
+ * - **직접**: 그 밖의 https. 부트스트랩 때 잡아 둔 프레임의 원래 `fetch`로 `credentials: 'omit'`·
+ *   `referrerPolicy: 'no-referrer'`를 덮어 부른다. 인증 헤더는 붙이지 않는다(토큰은 프레임에 없다).
+ * - **거절**(`TypeError`): hostOrigin의 게이트웨이 밖 경로(혼동 방지 — 직접 보내지 않는다), https가 아닌 스킴.
+ *
+ * **자기완결 함수다** — `bridgeRuntime`과 함께 srcdoc에 `toString()`으로 심긴다(runtime.ts 주석 참고).
+ * 템플릿 코드보다 먼저 돌고, 판정·전송에 쓰는 전역(`fetch`·`URL`과 그 접근자·`String.prototype.slice`·
+ * `Promise.prototype.then`·`Object.assign`·`TypeError`)과 init의 라우팅 목록을 이때 잡아 둔다. 그래서 템플릿이
+ * 나중에 전역·프로토타입·init 객체를 바꿔도 갈래가 바뀌지 않는다. 갈래가 바뀌어도 토큰은 새지 않는다 —
+ * 브리지로 간 요청은 호스트가 따로 판정하고, 직접 간 요청에는 토큰이 없다. 이 고정은 혼동 방지다.
+ *
+ * init이 `gatewayPrefixes`를 싣지 않으면(옛 호스트) hostOrigin 요청은 경로와 무관하게 브리지로 보낸다
+ * (호스트가 판정하므로 안전한 쪽).
+ *
+ * @param g 프레임 전역(`globalThis`)
+ * @param client 프레임 브리지 클라이언트(`bridgeRuntime` 결과, frozen)
+ * @param config srcdoc에 심긴 hostOrigin
+ * @returns 설치한 fetch 라우터
+ */
+declare function installDirectFetch(g: DirectFetchGlobal, client: Pick<BridgeClient, 'fetch' | 'ready'>, config: DirectFetchConfig): typeof globalThis.fetch;
+
+/** `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-CRGnyf-6.js';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap, z as TemplateReportKind } from './messages-Cdjpvu2S.js';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -73,4 +73,89 @@ declare function createBridgeClient(options?: CreateBridgeClientOptions): Bridge
  */
 declare function createBridgeFetch(client: BridgeRequester): typeof globalThis.fetch;
 
-export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type Unsubscribe, createBridgeClient, createBridgeFetch };
+/** `installDirectFetch` 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
+interface DirectFetchConfig {
+    /** 호스트 페이지 origin(srcdoc에 심긴 값). 상대 URL의 기준이자 "같은 origin" 판정 기준. */
+    readonly hostOrigin: string;
+}
+/** 프레임 fetch 라우터가 쓰는 전역의 최소 모양 — 테스트에서 가짜 창을 넘길 수 있게 한다. */
+interface DirectFetchGlobal {
+    fetch?: typeof globalThis.fetch;
+    URL?: typeof URL;
+    Request?: typeof Request;
+    __bstage_fetch__?: typeof globalThis.fetch;
+}
+/** 갈래 판정 결과. */
+type DirectRoute = 'bridge' | 'direct' | 'reject';
+/**
+ * 격리 프레임의 fetch 라우터를(`createSrcdoc` 부트스트랩이 항상 설치한다, README "프레임 네트워크")
+ * `globalThis.__bstage_fetch__`에 설치한다. inline 모드용으로 쓰인 템플릿이 부르는 그 이름이다.
+ *
+ * 갈래(`new URL(input, hostOrigin)`으로 정규화한 뒤):
+ * - **브리지**(토큰이 필요한 목적지): hostOrigin과 같은 origin이고 경로가 init `gatewayPrefixes` 안, 또는
+ *   origin이 init `partnerOrigins`와 정확히 일치. 기존 브리지 fetch(`client.fetch`)로 보내고 호스트가 다시 판정한다.
+ * - **직접**: 그 밖의 https. 부트스트랩 때 잡아 둔 프레임의 원래 `fetch`로 `credentials: 'omit'`·
+ *   `referrerPolicy: 'no-referrer'`를 덮어 부른다. 인증 헤더는 붙이지 않는다(토큰은 프레임에 없다).
+ * - **거절**(`TypeError`): hostOrigin의 게이트웨이 밖 경로(혼동 방지 — 직접 보내지 않는다), https가 아닌 스킴.
+ *
+ * **자기완결 함수다** — `bridgeRuntime`과 함께 srcdoc에 `toString()`으로 심긴다(runtime.ts 주석 참고).
+ * 템플릿 코드보다 먼저 돌고, 판정·전송에 쓰는 전역(`fetch`·`URL`과 그 접근자·`String.prototype.slice`·
+ * `Promise.prototype.then`·`Object.assign`·`TypeError`)과 init의 라우팅 목록을 이때 잡아 둔다. 그래서 템플릿이
+ * 나중에 전역·프로토타입·init 객체를 바꿔도 갈래가 바뀌지 않는다. 갈래가 바뀌어도 토큰은 새지 않는다 —
+ * 브리지로 간 요청은 호스트가 따로 판정하고, 직접 간 요청에는 토큰이 없다. 이 고정은 혼동 방지다.
+ *
+ * init이 `gatewayPrefixes`를 싣지 않으면(옛 호스트) hostOrigin 요청은 경로와 무관하게 브리지로 보낸다
+ * (호스트가 판정하므로 안전한 쪽).
+ *
+ * @param g 프레임 전역(`globalThis`)
+ * @param client 프레임 브리지 클라이언트(`bridgeRuntime` 결과, frozen)
+ * @param config srcdoc에 심긴 hostOrigin
+ * @returns 설치한 fetch 라우터
+ */
+declare function installDirectFetch(g: DirectFetchGlobal, client: Pick<BridgeClient, 'fetch' | 'ready'>, config: DirectFetchConfig): typeof globalThis.fetch;
+
+/** `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,7 +1,9 @@
 import {
   bridgeRuntime,
-  createBridgeFetch
-} from "./chunk-N3JID7KQ.js";
+  createBridgeFetch,
+  installDirectFetch,
+  installErrorReport
+} from "./chunk-TPKNGW34.js";
 
 // src/frame/createBridgeClient.ts
 var BRIDGE_CONFIG_GLOBAL = "__bstage_bridge_config__";
@@ -17,5 +19,7 @@ function createBridgeClient(options = {}) {
 }
 export {
   createBridgeClient,
-  createBridgeFetch
+  createBridgeFetch,
+  installDirectFetch,
+  installErrorReport
 };