@bstage-sdk/bridge 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-export { B as BRIDGE_ERROR_CODES, a as BRIDGE_SURFACES, b as BridgeError, c as BridgeErrorCode, d as BridgeErrorLike, e as BridgeEventMap, f as BridgeHostEventType, g as BridgeInit, h as BridgeLimits, i as BridgeRequestMap, j as BridgeRequestType, k as BridgeResult, l as BridgeSurface, m as BridgeTranslations, F as FRAME_UNLOAD_EVENT, n as FetchRequest, o as FetchResult, H as HOST_EVENT_TYPES, I as IFRAME_ATTRIBUTES, p as INIT_RESPONSE, L as LogLevel, M as MemberState, R as READY_EVENT, q as REQUEST_TIMEOUT_MS, r as REQUEST_TYPES, S as SlotState, s as StorageOp, T as ThemeState, t as ToastKind, W as WithSession, u as isBridgeErrorCode, v as isBridgeErrorLike, w as isBridgeSurface, x as isHostEventType, y as isRequestType } from './messages-BjpZyiLy.cjs';
-export { C as CreateSrcdocOptions, M as MAX_ELEMENT_NAME_LENGTH, a as MAX_MEDIA_ORIGINS, b as buildFrameCsp, c as createNonce, d as createSession, e as createSrcdoc, i as isValidNonce, f as isValidSession } from './createSrcdoc-DgQyvIjG.cjs';
+export { B as BRIDGE_ERROR_CODES, a as BRIDGE_SURFACES, b as BridgeError, c as BridgeErrorCode, d as BridgeErrorLike, e as BridgeEventMap, f as BridgeHostEventType, g as BridgeInit, h as BridgeLimits, i as BridgeRequestMap, j as BridgeRequestType, k as BridgeResult, l as BridgeSurface, m as BridgeTranslations, F as FRAME_UNLOAD_EVENT, n as FetchRequest, o as FetchResult, H as HOST_EVENT_TYPES, I as IFRAME_ATTRIBUTES, p as INIT_RESPONSE, L as LogLevel, M as MemberState, R as READY_EVENT, q as REPORTS_PER_SESSION, r as REPORT_COUNT_MAX, s as REPORT_FRAME_MAX_LENGTH, t as REPORT_MAX_FRAMES, u as REPORT_MESSAGE_MAX_LENGTH, v as REQUEST_TIMEOUT_MS, w as REQUEST_TYPES, S as SlotState, x as StorageOp, T as TEMPLATE_REPORT_KINDS, y as TemplateReport, z as TemplateReportKind, A as ThemeState, C as ToastKind, W as WithSession, D as isBridgeErrorCode, E as isBridgeErrorLike, G as isBridgeSurface, J as isHostEventType, K as isRequestType } from './messages-Cdjpvu2S.cjs';
+export { C as CreateSrcdocOptions, M as MAX_ELEMENT_NAME_LENGTH, a as MAX_MEDIA_ORIGINS, R as REPORT_FLUSH_DELAY_MS, b as buildFrameCsp, c as createNonce, d as createSession, e as createSrcdoc, i as isValidNonce, f as isValidSession } from './createSrcdoc-DYZk6dDJ.cjs';
 
 /** 봉투 버전. 형식이 하위 호환되지 않게 바뀔 때만 올린다. */
 declare const BRIDGE_VERSION = 1;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { B as BRIDGE_ERROR_CODES, a as BRIDGE_SURFACES, b as BridgeError, c as BridgeErrorCode, d as BridgeErrorLike, e as BridgeEventMap, f as BridgeHostEventType, g as BridgeInit, h as BridgeLimits, i as BridgeRequestMap, j as BridgeRequestType, k as BridgeResult, l as BridgeSurface, m as BridgeTranslations, F as FRAME_UNLOAD_EVENT, n as FetchRequest, o as FetchResult, H as HOST_EVENT_TYPES, I as IFRAME_ATTRIBUTES, p as INIT_RESPONSE, L as LogLevel, M as MemberState, R as READY_EVENT, q as REQUEST_TIMEOUT_MS, r as REQUEST_TYPES, S as SlotState, s as StorageOp, T as ThemeState, t as ToastKind, W as WithSession, u as isBridgeErrorCode, v as isBridgeErrorLike, w as isBridgeSurface, x as isHostEventType, y as isRequestType } from './messages-BjpZyiLy.js';
-export { C as CreateSrcdocOptions, M as MAX_ELEMENT_NAME_LENGTH, a as MAX_MEDIA_ORIGINS, b as buildFrameCsp, c as createNonce, d as createSession, e as createSrcdoc, i as isValidNonce, f as isValidSession } from './createSrcdoc-DgQyvIjG.js';
+export { B as BRIDGE_ERROR_CODES, a as BRIDGE_SURFACES, b as BridgeError, c as BridgeErrorCode, d as BridgeErrorLike, e as BridgeEventMap, f as BridgeHostEventType, g as BridgeInit, h as BridgeLimits, i as BridgeRequestMap, j as BridgeRequestType, k as BridgeResult, l as BridgeSurface, m as BridgeTranslations, F as FRAME_UNLOAD_EVENT, n as FetchRequest, o as FetchResult, H as HOST_EVENT_TYPES, I as IFRAME_ATTRIBUTES, p as INIT_RESPONSE, L as LogLevel, M as MemberState, R as READY_EVENT, q as REPORTS_PER_SESSION, r as REPORT_COUNT_MAX, s as REPORT_FRAME_MAX_LENGTH, t as REPORT_MAX_FRAMES, u as REPORT_MESSAGE_MAX_LENGTH, v as REQUEST_TIMEOUT_MS, w as REQUEST_TYPES, S as SlotState, x as StorageOp, T as TEMPLATE_REPORT_KINDS, y as TemplateReport, z as TemplateReportKind, A as ThemeState, C as ToastKind, W as WithSession, D as isBridgeErrorCode, E as isBridgeErrorLike, G as isBridgeSurface, J as isHostEventType, K as isRequestType } from './messages-Cdjpvu2S.js';
+export { C as CreateSrcdocOptions, M as MAX_ELEMENT_NAME_LENGTH, a as MAX_MEDIA_ORIGINS, R as REPORT_FLUSH_DELAY_MS, b as buildFrameCsp, c as createNonce, d as createSession, e as createSrcdoc, i as isValidNonce, f as isValidSession } from './createSrcdoc-DYZk6dDJ.js';
 
 /** 봉투 버전. 형식이 하위 호환되지 않게 바뀔 때만 올린다. */
 declare const BRIDGE_VERSION = 1;

package/dist/index.js

@@ -13,8 +13,15 @@ import {
   MAX_ENVELOPE_TYPE_LENGTH,
   MAX_MEDIA_ORIGINS,
   READY_EVENT,
+  REPORTS_PER_SESSION,
+  REPORT_COUNT_MAX,
+  REPORT_FLUSH_DELAY_MS,
+  REPORT_FRAME_MAX_LENGTH,
+  REPORT_MAX_FRAMES,
+  REPORT_MESSAGE_MAX_LENGTH,
   REQUEST_TIMEOUT_MS,
   REQUEST_TYPES,
+  TEMPLATE_REPORT_KINDS,
   buildFrameCsp,
   createEnvelope,
   createNonce,
@@ -29,8 +36,8 @@ import {
   isRequestType,
   isValidNonce,
   isValidSession
-} from "./chunk-ND2HFYBP.js";
-import "./chunk-CSAW3L7P.js";
+} from "./chunk-NXB47KPE.js";
+import "./chunk-TPKNGW34.js";
 export {
   BRIDGE_ERROR_CODES,
   BRIDGE_NAMESPACE,
@@ -46,8 +53,15 @@ export {
   MAX_ENVELOPE_TYPE_LENGTH,
   MAX_MEDIA_ORIGINS,
   READY_EVENT,
+  REPORTS_PER_SESSION,
+  REPORT_COUNT_MAX,
+  REPORT_FLUSH_DELAY_MS,
+  REPORT_FRAME_MAX_LENGTH,
+  REPORT_MAX_FRAMES,
+  REPORT_MESSAGE_MAX_LENGTH,
   REQUEST_TIMEOUT_MS,
   REQUEST_TYPES,
+  TEMPLATE_REPORT_KINDS,
   buildFrameCsp,
   createEnvelope,
   createNonce,

package/dist/{messages-BjpZyiLy.d.cts → messages-Cdjpvu2S.d.cts}

@@ -19,7 +19,7 @@ declare function isBridgeErrorLike(value: unknown): value is BridgeErrorLike;
 /** 프레임 요청 타임아웃. */
 declare const REQUEST_TIMEOUT_MS = 15000;
 /** 프레임 → 호스트 요청 종류(브리지 프로토콜 표). */
-declare const REQUEST_TYPES: readonly ["fetch", "navigate", "back", "openExternal", "toast", "resize", "track", "storage", "log"];
+declare const REQUEST_TYPES: readonly ["fetch", "navigate", "back", "openExternal", "toast", "resize", "track", "storage", "log", "report"];
 type BridgeRequestType = (typeof REQUEST_TYPES)[number];
 /** 호스트 → 프레임 이벤트 종류. */
 declare const HOST_EVENT_TYPES: readonly ["slot.context", "locale", "member", "theme", "visibility"];
@@ -101,6 +101,29 @@ interface FetchResult {
 type ToastKind = 'info' | 'success' | 'warning' | 'error';
 type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 type StorageOp = 'get' | 'set' | 'remove';
+/** 템플릿 에러 보고 종류 — 전역 에러, 처리 안 된 Promise 거절, 엔트리 스크립트 로드 실패. */
+declare const TEMPLATE_REPORT_KINDS: readonly ["error", "rejection", "load"];
+type TemplateReportKind = (typeof TEMPLATE_REPORT_KINDS)[number];
+/** report message 최대 길이(자). 프레임 수집기는 이 길이로 잘라 보내고, 호스트는 넘으면 거절한다. */
+declare const REPORT_MESSAGE_MAX_LENGTH = 300;
+/** report frames 최대 개수. */
+declare const REPORT_MAX_FRAMES = 10;
+/** report frame 한 줄 최대 길이(자). */
+declare const REPORT_FRAME_MAX_LENGTH = 200;
+/** report count 상한(같은 fingerprint 누적 횟수). 하한은 1. */
+declare const REPORT_COUNT_MAX = 100;
+/** 프레임 세션당 report 상한. 프레임 수집기와 호스트가 각자 지킨다. */
+declare const REPORTS_PER_SESSION = 5;
+/**
+ * `report` payload — 격리 프레임이 잡은 템플릿 에러 하나(같은 fingerprint는 count로 묶는다).
+ * URL·placement 같은 귀속 정보는 싣지 않는다 — 호스트가 자기가 띄운 템플릿으로 귀속한다.
+ */
+interface TemplateReport {
+    readonly kind: TemplateReportKind;
+    readonly message: string;
+    readonly frames: readonly string[];
+    readonly count: number;
+}
 /** 요청 type별 payload·결과 타입. */
 interface BridgeRequestMap {
     fetch: {
@@ -160,6 +183,10 @@ interface BridgeRequestMap {
         };
         res: Record<string, never>;
     };
+    report: {
+        req: TemplateReport;
+        res: Record<string, never>;
+    };
 }
 /** 이벤트 type별 payload. */
 interface BridgeEventMap {
@@ -194,4 +221,4 @@ declare const IFRAME_ATTRIBUTES: {
 declare function isRequestType(value: unknown): value is BridgeRequestType;
 declare function isHostEventType(value: unknown): value is BridgeHostEventType;
 
-export { BRIDGE_ERROR_CODES as B, FRAME_UNLOAD_EVENT as F, HOST_EVENT_TYPES as H, IFRAME_ATTRIBUTES as I, type LogLevel as L, type MemberState as M, READY_EVENT as R, type SlotState as S, type ThemeState as T, type WithSession as W, BRIDGE_SURFACES as a, BridgeError as b, type BridgeErrorCode as c, type BridgeErrorLike as d, type BridgeEventMap as e, type BridgeHostEventType as f, type BridgeInit as g, type BridgeLimits as h, type BridgeRequestMap as i, type BridgeRequestType as j, type BridgeResult as k, type BridgeSurface as l, type BridgeTranslations as m, type FetchRequest as n, type FetchResult as o, INIT_RESPONSE as p, REQUEST_TIMEOUT_MS as q, REQUEST_TYPES as r, type StorageOp as s, type ToastKind as t, isBridgeErrorCode as u, isBridgeErrorLike as v, isBridgeSurface as w, isHostEventType as x, isRequestType as y };
+export { type ThemeState as A, BRIDGE_ERROR_CODES as B, type ToastKind as C, isBridgeErrorCode as D, isBridgeErrorLike as E, FRAME_UNLOAD_EVENT as F, isBridgeSurface as G, HOST_EVENT_TYPES as H, IFRAME_ATTRIBUTES as I, isHostEventType as J, isRequestType as K, type LogLevel as L, type MemberState as M, READY_EVENT as R, type SlotState as S, TEMPLATE_REPORT_KINDS as T, type WithSession as W, BRIDGE_SURFACES as a, BridgeError as b, type BridgeErrorCode as c, type BridgeErrorLike as d, type BridgeEventMap as e, type BridgeHostEventType as f, type BridgeInit as g, type BridgeLimits as h, type BridgeRequestMap as i, type BridgeRequestType as j, type BridgeResult as k, type BridgeSurface as l, type BridgeTranslations as m, type FetchRequest as n, type FetchResult as o, INIT_RESPONSE as p, REPORTS_PER_SESSION as q, REPORT_COUNT_MAX as r, REPORT_FRAME_MAX_LENGTH as s, REPORT_MAX_FRAMES as t, REPORT_MESSAGE_MAX_LENGTH as u, REQUEST_TIMEOUT_MS as v, REQUEST_TYPES as w, type StorageOp as x, type TemplateReport as y, type TemplateReportKind as z };

package/dist/{messages-BjpZyiLy.d.ts → messages-Cdjpvu2S.d.ts}

@@ -19,7 +19,7 @@ declare function isBridgeErrorLike(value: unknown): value is BridgeErrorLike;
 /** 프레임 요청 타임아웃. */
 declare const REQUEST_TIMEOUT_MS = 15000;
 /** 프레임 → 호스트 요청 종류(브리지 프로토콜 표). */
-declare const REQUEST_TYPES: readonly ["fetch", "navigate", "back", "openExternal", "toast", "resize", "track", "storage", "log"];
+declare const REQUEST_TYPES: readonly ["fetch", "navigate", "back", "openExternal", "toast", "resize", "track", "storage", "log", "report"];
 type BridgeRequestType = (typeof REQUEST_TYPES)[number];
 /** 호스트 → 프레임 이벤트 종류. */
 declare const HOST_EVENT_TYPES: readonly ["slot.context", "locale", "member", "theme", "visibility"];
@@ -101,6 +101,29 @@ interface FetchResult {
 type ToastKind = 'info' | 'success' | 'warning' | 'error';
 type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 type StorageOp = 'get' | 'set' | 'remove';
+/** 템플릿 에러 보고 종류 — 전역 에러, 처리 안 된 Promise 거절, 엔트리 스크립트 로드 실패. */
+declare const TEMPLATE_REPORT_KINDS: readonly ["error", "rejection", "load"];
+type TemplateReportKind = (typeof TEMPLATE_REPORT_KINDS)[number];
+/** report message 최대 길이(자). 프레임 수집기는 이 길이로 잘라 보내고, 호스트는 넘으면 거절한다. */
+declare const REPORT_MESSAGE_MAX_LENGTH = 300;
+/** report frames 최대 개수. */
+declare const REPORT_MAX_FRAMES = 10;
+/** report frame 한 줄 최대 길이(자). */
+declare const REPORT_FRAME_MAX_LENGTH = 200;
+/** report count 상한(같은 fingerprint 누적 횟수). 하한은 1. */
+declare const REPORT_COUNT_MAX = 100;
+/** 프레임 세션당 report 상한. 프레임 수집기와 호스트가 각자 지킨다. */
+declare const REPORTS_PER_SESSION = 5;
+/**
+ * `report` payload — 격리 프레임이 잡은 템플릿 에러 하나(같은 fingerprint는 count로 묶는다).
+ * URL·placement 같은 귀속 정보는 싣지 않는다 — 호스트가 자기가 띄운 템플릿으로 귀속한다.
+ */
+interface TemplateReport {
+    readonly kind: TemplateReportKind;
+    readonly message: string;
+    readonly frames: readonly string[];
+    readonly count: number;
+}
 /** 요청 type별 payload·결과 타입. */
 interface BridgeRequestMap {
     fetch: {
@@ -160,6 +183,10 @@ interface BridgeRequestMap {
         };
         res: Record<string, never>;
     };
+    report: {
+        req: TemplateReport;
+        res: Record<string, never>;
+    };
 }
 /** 이벤트 type별 payload. */
 interface BridgeEventMap {
@@ -194,4 +221,4 @@ declare const IFRAME_ATTRIBUTES: {
 declare function isRequestType(value: unknown): value is BridgeRequestType;
 declare function isHostEventType(value: unknown): value is BridgeHostEventType;
 
-export { BRIDGE_ERROR_CODES as B, FRAME_UNLOAD_EVENT as F, HOST_EVENT_TYPES as H, IFRAME_ATTRIBUTES as I, type LogLevel as L, type MemberState as M, READY_EVENT as R, type SlotState as S, type ThemeState as T, type WithSession as W, BRIDGE_SURFACES as a, BridgeError as b, type BridgeErrorCode as c, type BridgeErrorLike as d, type BridgeEventMap as e, type BridgeHostEventType as f, type BridgeInit as g, type BridgeLimits as h, type BridgeRequestMap as i, type BridgeRequestType as j, type BridgeResult as k, type BridgeSurface as l, type BridgeTranslations as m, type FetchRequest as n, type FetchResult as o, INIT_RESPONSE as p, REQUEST_TIMEOUT_MS as q, REQUEST_TYPES as r, type StorageOp as s, type ToastKind as t, isBridgeErrorCode as u, isBridgeErrorLike as v, isBridgeSurface as w, isHostEventType as x, isRequestType as y };
+export { type ThemeState as A, BRIDGE_ERROR_CODES as B, type ToastKind as C, isBridgeErrorCode as D, isBridgeErrorLike as E, FRAME_UNLOAD_EVENT as F, isBridgeSurface as G, HOST_EVENT_TYPES as H, IFRAME_ATTRIBUTES as I, isHostEventType as J, isRequestType as K, type LogLevel as L, type MemberState as M, READY_EVENT as R, type SlotState as S, TEMPLATE_REPORT_KINDS as T, type WithSession as W, BRIDGE_SURFACES as a, BridgeError as b, type BridgeErrorCode as c, type BridgeErrorLike as d, type BridgeEventMap as e, type BridgeHostEventType as f, type BridgeInit as g, type BridgeLimits as h, type BridgeRequestMap as i, type BridgeRequestType as j, type BridgeResult as k, type BridgeSurface as l, type BridgeTranslations as m, type FetchRequest as n, type FetchResult as o, INIT_RESPONSE as p, REPORTS_PER_SESSION as q, REPORT_COUNT_MAX as r, REPORT_FRAME_MAX_LENGTH as s, REPORT_MAX_FRAMES as t, REPORT_MESSAGE_MAX_LENGTH as u, REQUEST_TIMEOUT_MS as v, REQUEST_TYPES as w, type StorageOp as x, type TemplateReport as y, type TemplateReportKind as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bstage-sdk/bridge",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "bstage SDK bridge — isolated template iframe protocol, host policy and frame client",
   "type": "module",
   "publishConfig": {