@bstage-sdk/bridge 0.9.1 → 0.11.0

package/dist/frame.cjs

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var frame_exports = {};
 __export(frame_exports, {
   createBridgeClient: () => createBridgeClient,
-  createBridgeFetch: () => createBridgeFetch
+  createBridgeFetch: () => createBridgeFetch,
+  installDirectFetch: () => installDirectFetch
 });
 module.exports = __toCommonJS(frame_exports);
 
@@ -130,6 +131,20 @@ function bridgeRuntime(g, makeFetch, config) {
   const session = config.session;
   const hostOrigin = config.hostOrigin;
   const parent = g.parent;
+  const sendToHost = parent ? parent.postMessage.bind(parent) : void 0;
+  const stopInterval = clearInterval;
+  const stopTimeout = clearTimeout;
+  let readPersisted;
+  const ownDescriptor = Object.getOwnPropertyDescriptor;
+  const hasOwn = Function.prototype.call.bind(Object.prototype.hasOwnProperty);
+  try {
+    const pte = g.PageTransitionEvent;
+    const desc = pte ? Object.getOwnPropertyDescriptor(pte.prototype, "persisted") : void 0;
+    if (desc && typeof desc.get === "function")
+      readPersisted = Function.prototype.call.bind(desc.get);
+  } catch {
+    readPersisted = void 0;
+  }
   const pending = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Map();
   let init;
@@ -146,6 +161,17 @@ function bridgeRuntime(g, makeFetch, config) {
     return out;
   }
   const idPrefix = randomPrefix();
+  function secureToken() {
+    if (!g.crypto || typeof g.crypto.getRandomValues !== "function") return "";
+    const bytes = new Uint8Array(16);
+    g.crypto.getRandomValues(bytes);
+    let out = "";
+    for (let i = 0; i < bytes.length; i += 1) out += (bytes[i] + 256).toString(16).slice(1);
+    return out;
+  }
+  const frameToken = secureToken();
+  let closed = frameToken === "";
+  let unloaded = false;
   function nextId() {
     seq += 1;
     return idPrefix + "-" + seq;
@@ -157,9 +183,12 @@ function bridgeRuntime(g, makeFetch, config) {
     return err;
   }
   function post(kind, type, id, payload) {
-    if (!parent) return;
+    if (!sendToHost || closed) return;
     const body = Object.assign({}, payload, { session });
-    parent.postMessage({ v: 1, ns: NS, id, kind, type, payload: body }, hostOrigin);
+    sendToHost(
+      { v: 1, ns: NS, id, kind, type, payload: body, frame: frameToken },
+      hostOrigin
+    );
   }
   function isEnvelope(m) {
     if (typeof m !== "object" || m === null) return false;
@@ -232,6 +261,54 @@ function bridgeRuntime(g, makeFetch, config) {
     }
   }
   g.addEventListener("message", onMessage);
+  function isPersisted(ev) {
+    try {
+      if (readPersisted) return readPersisted(ev) === true;
+      if (typeof ev !== "object" || ev === null) return false;
+      const desc = ownDescriptor(ev, "persisted");
+      return !!desc && hasOwn(desc, "value") && desc.value === true;
+    } catch {
+      return false;
+    }
+  }
+  function onPageHide(ev) {
+    if (unloaded || isPersisted(ev)) return;
+    unloaded = true;
+    closed = true;
+    if (sendToHost) {
+      try {
+        sendToHost(
+          {
+            v: 1,
+            ns: NS,
+            id: idPrefix + "-unload",
+            kind: "evt",
+            type: "frame-unload",
+            payload: { session },
+            frame: frameToken
+          },
+          hostOrigin
+        );
+      } catch {
+      }
+    }
+    try {
+      stopInterval(readyTimer);
+    } catch {
+    }
+    try {
+      pending.forEach(function(entry) {
+        try {
+          stopTimeout(entry.timer);
+          entry.reject(codeError("UNSUPPORTED", "bridge closed"));
+        } catch {
+        }
+      });
+      pending.clear();
+    } catch {
+    }
+  }
+  g.addEventListener("pagehide", onPageHide, true);
   let readyAttempts = 0;
   function sendReady() {
     readyAttempts += 1;
@@ -245,6 +322,10 @@ function bridgeRuntime(g, makeFetch, config) {
   sendReady();
   function request(type, payload) {
     return new Promise(function(resolve, reject) {
+      if (closed) {
+        reject(codeError("UNSUPPORTED", "bridge closed"));
+        return;
+      }
       const id = nextId();
       const timer = setTimeout(function() {
         pending.delete(id);
@@ -299,8 +380,129 @@ 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;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createBridgeClient,
-  createBridgeFetch
+  createBridgeFetch,
+  installDirectFetch
 });

package/dist/frame.d.cts

@@ -1,4 +1,4 @@
-import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-9N0GFq5b.cjs';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-BjpZyiLy.cjs';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -28,14 +28,18 @@ interface RuntimeGlobal {
     parent: {
         postMessage(message: unknown, targetOrigin: string): void;
     } | null;
-    addEventListener(type: 'message', fn: (ev: {
-        source: unknown;
-        origin: string;
-        data: unknown;
-    }) => void): void;
+    /**
+     * `message`(호스트 응답·이벤트)와 `pagehide`(frame-unload 전송, capture)에 쓴다.
+     * 처리기 인자 모양은 type마다 다르다 — message는 `{ source, origin, data }`, pagehide는 `{ persisted }`.
+     */
+    addEventListener(type: 'message' | 'pagehide', fn: (ev: never) => void, capture?: boolean): void;
     crypto?: {
         getRandomValues<T extends ArrayBufferView | null>(array: T): T;
     };
+    /** pagehide 이벤트 생성자 — `persisted` 원본 접근자를 부트스트랩 때 잡는 데 쓴다(없으면 이벤트 속성을 읽는다). */
+    PageTransitionEvent?: {
+        readonly prototype: object;
+    };
     __bstage_bridge__?: BridgeClient;
 }
 /** `createBridgeFetch`가 요구하는 클라이언트 부분. */
@@ -69,4 +73,45 @@ 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;
+
+export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch };

package/dist/frame.d.ts

@@ -1,4 +1,4 @@
-import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-9N0GFq5b.js';
+import { g as BridgeInit, j as BridgeRequestType, i as BridgeRequestMap, e as BridgeEventMap } from './messages-BjpZyiLy.js';
 
 /** 프레임 런타임 설정 — srcdoc 부트스트랩이 상수로 넘긴다. */
 interface BridgeClientConfig {
@@ -28,14 +28,18 @@ interface RuntimeGlobal {
     parent: {
         postMessage(message: unknown, targetOrigin: string): void;
     } | null;
-    addEventListener(type: 'message', fn: (ev: {
-        source: unknown;
-        origin: string;
-        data: unknown;
-    }) => void): void;
+    /**
+     * `message`(호스트 응답·이벤트)와 `pagehide`(frame-unload 전송, capture)에 쓴다.
+     * 처리기 인자 모양은 type마다 다르다 — message는 `{ source, origin, data }`, pagehide는 `{ persisted }`.
+     */
+    addEventListener(type: 'message' | 'pagehide', fn: (ev: never) => void, capture?: boolean): void;
     crypto?: {
         getRandomValues<T extends ArrayBufferView | null>(array: T): T;
     };
+    /** pagehide 이벤트 생성자 — `persisted` 원본 접근자를 부트스트랩 때 잡는 데 쓴다(없으면 이벤트 속성을 읽는다). */
+    PageTransitionEvent?: {
+        readonly prototype: object;
+    };
     __bstage_bridge__?: BridgeClient;
 }
 /** `createBridgeFetch`가 요구하는 클라이언트 부분. */
@@ -69,4 +73,45 @@ 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;
+
+export { type BridgeClient, type BridgeClientConfig, type BridgeRequester, type CreateBridgeClientOptions, type DirectFetchConfig, type DirectFetchGlobal, type DirectRoute, type Unsubscribe, createBridgeClient, createBridgeFetch, installDirectFetch };

package/dist/frame.js

@@ -1,7 +1,8 @@
 import {
   bridgeRuntime,
-  createBridgeFetch
-} from "./chunk-KQMJY4ZH.js";
+  createBridgeFetch,
+  installDirectFetch
+} from "./chunk-CSAW3L7P.js";
 
 // src/frame/createBridgeClient.ts
 var BRIDGE_CONFIG_GLOBAL = "__bstage_bridge_config__";
@@ -17,5 +18,6 @@ function createBridgeClient(options = {}) {
 }
 export {
   createBridgeClient,
-  createBridgeFetch
+  createBridgeFetch,
+  installDirectFetch
 };