@cp949/iframecall 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)을 따르며, 버전 관리는 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)을 준수합니다. 0.x 버전대에서는 호환성이 깨지는 변경도 minor 버전 증가로 처리합니다.
 
+## [0.2.1] - 2026-08-25
+
+### Added
+
+- host controller의 정식 command 실행 API로 `invoke(command, args, options?)`를 추가했습니다.
+
+### Deprecated
+
+- `controller.call()`은 호환성을 위해 유지하지만 다음 major release에서 제거할 예정입니다. `controller.invoke()`를 사용하세요.
+
 ## [0.2.0] - 2026-04-28
 
 ### Added

package/README.md

@@ -20,16 +20,16 @@ yarn add @cp949/iframecall
 
 `react`, `@types/react`는 peer dependency이다. 프로젝트에 이미 설치되어 있어야 한다.
 
-| peer | 지원 버전 |
-|------|-----------|
-| `react` | `^18.0.0 \|\| ^19.0.0` |
+| peer           | 지원 버전              |
+| -------------- | ---------------------- |
+| `react`        | `^18.0.0 \|\| ^19.0.0` |
 | `@types/react` | `^18.0.0 \|\| ^19.0.0` |
 
 ## 진입점
 
-| import | 용도 |
-|--------|------|
-| `@cp949/iframecall/host` | 부모 페이지(host)에서 iframe을 제어할 때 |
+| import                     | 용도                                              |
+| -------------------------- | ------------------------------------------------- |
+| `@cp949/iframecall/host`   | 부모 페이지(host)에서 iframe을 제어할 때          |
 | `@cp949/iframecall/iframe` | 임베드된 페이지(iframe)에서 host의 호출을 받을 때 |
 
 호스트와 iframe은 서로 다른 origin에서 실행되며, 각 진입점은 그쪽에서만 필요한 API와 타입만 노출한다.
@@ -84,7 +84,7 @@ export function HostPage() {
 
   const handleGreet = async () => {
     if (!controller) return;
-    const result = await controller.call("greet", ["World"]);
+    const result = await controller.invoke("greet", ["World"]);
     console.log(result); // "Hello, World!"
   };
 
@@ -94,11 +94,7 @@ export function HostPage() {
       <button type="button" onClick={handleGreet} disabled={status !== "ready"}>
         Greet
       </button>
-      <iframe
-        ref={iframeRef}
-        src={IFRAME_ORIGIN}
-        title="iframe demo"
-      />
+      <iframe ref={iframeRef} src={IFRAME_ORIGIN} title="iframe demo" />
     </div>
   );
 }
@@ -110,11 +106,11 @@ export function HostPage() {
 
 prefix 컨벤션:
 
-| prefix | 의미 |
-|--------|------|
-| (없음) | host로 dispatch되는 remote command |
-| `_` | 사용자 local-only 메서드. dispatch 대상에서 제외된다. (예: `_sendLifecycleReady`, `_onStatusChange`) |
-| `$` | 라이브러리 점유 namespace. dispatch에서 제외되며, 라이브러리가 정의한 hook 이름만 의미가 있다. |
+| prefix | 의미                                                                                                 |
+| ------ | ---------------------------------------------------------------------------------------------------- |
+| (없음) | host로 dispatch되는 remote command                                                                   |
+| `_`    | 사용자 local-only 메서드. dispatch 대상에서 제외된다. (예: `_sendLifecycleReady`, `_onStatusChange`) |
+| `$`    | 라이브러리 점유 namespace. dispatch에서 제외되며, 라이브러리가 정의한 hook 이름만 의미가 있다.       |
 
 현재 라이브러리가 인식하는 hook은 한 개:
 
@@ -222,7 +218,7 @@ host                                    iframe
   │  ◀── ready ───────────────────────────│  (lifecycle 채널)
   │  controller.status = "ready"          │
   │                                       │
-  │  controller.call("greet", ["World"])  │
+  │  controller.invoke("greet", ["World"])│
   │  ── request ─────────────────────────▶│ $onCommandRun → AppCommands.greet("World")
   │  ◀── notify status-changed:processing │  (도메인 채널, refcount 0→1)
   │  ◀── response: "Hello, World!" ───────│
@@ -230,7 +226,7 @@ host                                    iframe
 ```
 
 - iframe이 마운트되면 `commands._sendLifecycleReady()`가 `sendLifecycleReady()`를 통해 transport ready 신호를 보낸다.
-- host의 `controller.call`은 ready 시점까지 대기한 뒤 전송된다.
+- host의 `controller.invoke`는 ready 시점까지 대기한 뒤 전송된다.
 - 응답은 Promise로 돌아오며, iframe 측 메서드가 throw하면 host 쪽 Promise는 reject된다.
 - iframe → host 단방향 알림은 `sendNotificationToHost`로 보내고, host 쪽에서 `controller.onNotificationFromIframe`으로 받는다.
 - **라이프사이클 채널과 도메인 채널은 책임이 다르다.** `ready`/`terminated`는 transport 신호 전용이고, 도메인 알림(`status-changed` 등)에는 `"ready"` 같은 lifecycle 의미를 담지 않는다.
@@ -240,16 +236,17 @@ host                                    iframe
 
 ### host 진입점
 
-| export | 종류 | 설명 |
-|--------|------|------|
-| `useIframeCallController` | hook | host용 React 훅. `iframeRef`, `controller`, `status`를 반환한다. |
-| `createIframeCallController` | factory | 훅 없이 컨트롤러를 직접 만들 때 사용 |
-| `createIframeWindowTransport` | factory | 커스텀 트랜스포트 구성용 |
-| `consoleDebugLogger` | util | 디버그 이벤트를 콘솔에 출력하는 로거 |
+| export                        | 종류    | 설명                                                             |
+| ----------------------------- | ------- | ---------------------------------------------------------------- |
+| `useIframeCallController`     | hook    | host용 React 훅. `iframeRef`, `controller`, `status`를 반환한다. |
+| `createIframeCallController`  | factory | 훅 없이 컨트롤러를 직접 만들 때 사용                             |
+| `createIframeWindowTransport` | factory | 커스텀 트랜스포트 구성용                                         |
+| `consoleDebugLogger`          | util    | 디버그 이벤트를 콘솔에 출력하는 로거                             |
 
 훅이 반환하는 `controller`의 주요 멤버:
 
-- `controller.call(command, args, options?)` — iframe의 커맨드 호출, 결과를 Promise로 반환
+- `controller.invoke(command, args, options?)` — iframe의 커맨드 호출, 결과를 Promise로 반환
+- `controller.call(command, args, options?)` — deprecated 호환 alias. `invoke`를 사용하세요.
 - `controller.onNotificationFromIframe(event, handler)` — iframe이 보내는 알림 구독, unsubscribe 함수 반환
 - `controller.ready` — iframe ready 신호 대기용 Promise
 - `controller.terminated` — 종료 사유를 노출하는 Promise (정상 dispose면 `null`)
@@ -258,11 +255,11 @@ host                                    iframe
 
 ### iframe 진입점
 
-| export | 종류 | 설명 |
-|--------|------|------|
-| `useIframeCallRunner` | hook | iframe용 React 훅. `commands`, `iframeHelper`, `isActive`를 반환한다. mount 전 `commands`/`iframeHelper`는 `null`. |
-| `createIframeCallRunner` | factory | 훅 없이 러너를 직접 만들 때 사용 |
-| `createParentWindowTransport` | factory | 커스텀 트랜스포트 구성용 |
+| export                        | 종류    | 설명                                                                                                               |
+| ----------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
+| `useIframeCallRunner`         | hook    | iframe용 React 훅. `commands`, `iframeHelper`, `isActive`를 반환한다. mount 전 `commands`/`iframeHelper`는 `null`. |
+| `createIframeCallRunner`      | factory | 훅 없이 러너를 직접 만들 때 사용                                                                                   |
+| `createParentWindowTransport` | factory | 커스텀 트랜스포트 구성용                                                                                           |
 
 `iframeHelper`의 주요 멤버:
 
@@ -276,7 +273,7 @@ host                                    iframe
 - `_` prefix → 사용자 local-only (dispatch 제외)
 - `$` prefix → 라이브러리 namespace (dispatch 제외, 인식되는 hook은 `$onCommandRun`)
 
-`onStatusChange`처럼 prefix가 없으면서 host에서 호출하면 안 되는 메서드는 반드시 `_` prefix를 붙여야 한다. 그렇지 않으면 host가 `controller.call("onStatusChange", [...])`로 직접 호출할 수 있다.
+`onStatusChange`처럼 prefix가 없으면서 host에서 호출하면 안 되는 메서드는 반드시 `_` prefix를 붙여야 한다. 그렇지 않으면 host가 `controller.invoke("onStatusChange", [...])`로 직접 호출할 수 있다.
 
 > 알림은 iframe → host 단방향이다. host → iframe 알림은 라이브러리 외부에서 `postMessage`로 직접 처리하거나, host에서 커맨드를 호출해 처리한다.
 
@@ -288,9 +285,9 @@ host                                    iframe
 
 `targetOrigin`과 `allowedOrigins`는 반드시 명시적으로 지정한다. 와일드카드(`*`)는 사용하지 않는다.
 
-| 옵션 | 의미 |
-|------|------|
-| `targetOrigin` | `postMessage` 전송 시 사용할 대상 origin |
+| 옵션             | 의미                                      |
+| ---------------- | ----------------------------------------- |
+| `targetOrigin`   | `postMessage` 전송 시 사용할 대상 origin  |
 | `allowedOrigins` | 수신 시 허용할 origin 화이트리스트 (배열) |
 
 수신 메시지의 `event.origin`이 화이트리스트에 없으면 무시된다.

package/dist/{chunk-UYZXYOI6.js → chunk-RSUK22E2.js}

@@ -111,10 +111,12 @@ function isRecord(value) {
 
 // src/core/transport.ts
 function createIframeWindowTransport(iframe) {
+  var _a;
   return {
-    expectedSource: iframe.contentWindow ?? void 0,
+    expectedSource: (_a = iframe.contentWindow) != null ? _a : void 0,
     post(message, targetOrigin, transfer) {
-      iframe.contentWindow?.postMessage(
+      var _a2;
+      (_a2 = iframe.contentWindow) == null ? void 0 : _a2.postMessage(
         message,
         targetOrigin,
         transfer

package/dist/host.d.ts

@@ -1,5 +1,5 @@
-import { H as HostDebugEvent, C as CommandMap, I as IframeCallControllerOptions, a as IframeCallController, S as SerializedIframeCallError } from './messages-BuRipoIx.js';
-export { b as CommandArgs, c as CommandHandler, d as CommandResult, e as CommandRunner, f as IframeCallCallOptions, g as IframeCallLogger, h as IframeCallNotify, i as IframeCallRequest, j as IframeCallResponse, k as IframeCallTransferable, l as IframeCallTransport, m as IframeCallTransportEvent, N as NotifyHandler, P as ParsedIframeCallMessage, R as ReadyPolicy, n as ReservedNotificationName, o as createIframeCallError, p as createIframeCallErrorResponse, q as createIframeCallNotify, r as createIframeCallRequest, s as createIframeCallSuccessResponse, t as createIframeWindowTransport, u as isSerializedIframeCallError, v as parseIframeCallMessage, w as serializeIframeCallError } from './messages-BuRipoIx.js';
+import { H as HostDebugEvent, C as CommandMap, I as IframeCallControllerOptions, a as IframeCallController, S as SerializedIframeCallError } from './messages-uOmcU6eT.js';
+export { b as CommandArgs, c as CommandHandler, d as CommandResult, e as CommandRunner, f as IframeCallCallOptions, g as IframeCallLogger, h as IframeCallNotify, i as IframeCallRequest, j as IframeCallResponse, k as IframeCallTransferable, l as IframeCallTransport, m as IframeCallTransportEvent, N as NotifyHandler, P as ParsedIframeCallMessage, R as ReadyPolicy, n as ReservedNotificationName, o as createIframeCallError, p as createIframeCallErrorResponse, q as createIframeCallNotify, r as createIframeCallRequest, s as createIframeCallSuccessResponse, t as createIframeWindowTransport, u as isSerializedIframeCallError, v as parseIframeCallMessage, w as serializeIframeCallError } from './messages-uOmcU6eT.js';
 
 /** consoleDebugLogger 옵션. prefix를 명시하지 않으면 [iframecall:host]가 기본값이다. */
 type ConsoleDebugLoggerOptions = {

package/dist/host.js

@@ -8,11 +8,12 @@ import {
   isSerializedIframeCallError,
   parseIframeCallMessage,
   serializeIframeCallError
-} from "./chunk-UYZXYOI6.js";
+} from "./chunk-RSUK22E2.js";
 
 // src/host/consoleDebugLogger.ts
 function consoleDebugLogger(options = {}) {
-  const prefix = options.prefix ?? "[iframecall:host]";
+  var _a;
+  const prefix = (_a = options.prefix) != null ? _a : "[iframecall:host]";
   const head = prefix.length > 0 ? `${prefix} ` : "";
   return (event) => {
     switch (event.type) {
@@ -95,7 +96,7 @@ function createControllerLifecycle(options) {
       return;
     }
     cleanupDone = true;
-    onCleanup?.();
+    onCleanup == null ? void 0 : onCleanup();
   }
   return {
     ready,
@@ -117,7 +118,8 @@ function createNotifyHandlerRegistry() {
   const handlers = /* @__PURE__ */ new Map();
   return {
     register(event, handler) {
-      const set = handlers.get(event) ?? /* @__PURE__ */ new Set();
+      var _a;
+      const set = (_a = handlers.get(event)) != null ? _a : /* @__PURE__ */ new Set();
       set.add(handler);
       handlers.set(event, set);
       return () => {
@@ -203,7 +205,8 @@ function createPendingCallRegistry(transport, targetOrigin) {
       pending.clear();
     },
     getCommand(id) {
-      return pending.get(id)?.command;
+      var _a;
+      return (_a = pending.get(id)) == null ? void 0 : _a.command;
     }
   };
 }
@@ -244,24 +247,26 @@ function createReadyQueue() {
 
 // src/host/controller.ts
 function createIframeCallController(options) {
+  var _a, _b, _c, _d, _e, _f, _g;
   const targetOrigin = requireTargetOrigin(options.targetOrigin);
-  const allowedOrigins = new Set(options.allowedOrigins ?? [targetOrigin]);
-  const transport = options.transport ?? createIframeWindowTransport(options.iframe);
-  const generateId = options.generateId ?? crypto.randomUUID.bind(crypto);
-  const defaultTimeoutMs = options.defaultTimeoutMs ?? 3e4;
-  const readyTimeoutMs = options.readyTimeoutMs ?? defaultTimeoutMs;
-  const readyPolicy = options.readyPolicy ?? "queue";
-  const readyQueueLimit = options.readyQueueLimit ?? Number.POSITIVE_INFINITY;
+  const allowedOrigins = new Set((_a = options.allowedOrigins) != null ? _a : [targetOrigin]);
+  const transport = (_b = options.transport) != null ? _b : createIframeWindowTransport(options.iframe);
+  const generateId = (_c = options.generateId) != null ? _c : createDefaultRequestId;
+  const defaultTimeoutMs = (_d = options.defaultTimeoutMs) != null ? _d : 3e4;
+  const readyTimeoutMs = (_e = options.readyTimeoutMs) != null ? _e : defaultTimeoutMs;
+  const readyPolicy = (_f = options.readyPolicy) != null ? _f : "queue";
+  const readyQueueLimit = (_g = options.readyQueueLimit) != null ? _g : Number.POSITIVE_INFINITY;
   const pending = createPendingCallRegistry(transport, targetOrigin);
   const queue = createReadyQueue();
   const notifyRegistry = createNotifyHandlerRegistry();
   const debugSubscribers = /* @__PURE__ */ new Set();
   function emitDebug(event) {
+    var _a2;
     for (const handler of debugSubscribers) {
       try {
         handler(event);
       } catch (error) {
-        options.logger?.warn("iframecall debug subscriber threw.", error);
+        (_a2 = options.logger) == null ? void 0 : _a2.warn("iframecall debug subscriber threw.", error);
       }
     }
   }
@@ -289,68 +294,67 @@ function createIframeCallController(options) {
     unsubscribeTransport();
     notifyRegistry.clear();
   });
-  const controller = {
-    ready: lifecycle.ready,
-    terminated: lifecycle.terminated,
-    call(cmd, args, callOptions) {
-      const terminatedError = lifecycle.getTerminatedError();
-      if (terminatedError !== null) {
-        return Promise.reject(terminatedError);
-      }
-      if (!lifecycle.isReady() && readyPolicy === "reject") {
-        return Promise.reject(
-          createIframeCallError("not_ready", "Iframe is not ready.", {
-            command: cmd
+  const invoke = (cmd, args, callOptions) => {
+    var _a2;
+    const terminatedError = lifecycle.getTerminatedError();
+    if (terminatedError !== null) {
+      return Promise.reject(terminatedError);
+    }
+    if (!lifecycle.isReady() && readyPolicy === "reject") {
+      return Promise.reject(
+        createIframeCallError("not_ready", "Iframe is not ready.", {
+          command: cmd
+        })
+      );
+    }
+    const id = generateId();
+    const timeoutMs = (_a2 = callOptions == null ? void 0 : callOptions.timeoutMs) != null ? _a2 : defaultTimeoutMs;
+    return new Promise((resolve, reject) => {
+      const timeoutId = timeoutMs === 0 || timeoutMs === Number.POSITIVE_INFINITY ? null : setTimeout(() => {
+        pending.delete(id);
+        queue.delete(id);
+        reject(
+          createIframeCallError("timeout", "Command timed out.", {
+            command: cmd,
+            details: { timeoutMs }
           })
         );
-      }
-      const id = generateId();
-      const timeoutMs = callOptions?.timeoutMs ?? defaultTimeoutMs;
-      return new Promise((resolve, reject) => {
-        const timeoutId = timeoutMs === 0 || timeoutMs === Number.POSITIVE_INFINITY ? null : setTimeout(() => {
-          pending.delete(id);
-          queue.delete(id);
+      }, timeoutMs);
+      const call = {
+        command: cmd,
+        timeoutId,
+        resolve,
+        reject
+      };
+      if (!lifecycle.isReady()) {
+        if (queue.size() >= readyQueueLimit) {
+          if (timeoutId !== null) clearTimeout(timeoutId);
           reject(
-            createIframeCallError("timeout", "Command timed out.", {
+            createIframeCallError("queue_overflow", "Ready queue overflow.", {
               command: cmd,
-              details: { timeoutMs }
+              details: { readyQueueLimit }
             })
           );
-        }, timeoutMs);
-        const call = {
-          command: cmd,
-          timeoutId,
-          resolve,
-          reject
-        };
-        if (!lifecycle.isReady()) {
-          if (queue.size() >= readyQueueLimit) {
-            if (timeoutId !== null) {
-              clearTimeout(timeoutId);
-            }
-            reject(
-              createIframeCallError(
-                "queue_overflow",
-                "Ready queue overflow.",
-                {
-                  command: cmd,
-                  details: { readyQueueLimit }
-                }
-              )
-            );
-            return;
-          }
-          queue.add(id, {
-            ...call,
-            args,
-            transfer: callOptions?.transfer
-          });
           return;
         }
-        emitDebug({ type: "commandSentToIframe", command: cmd, args });
-        pending.add(id, call);
-        pending.post(id, cmd, args, callOptions?.transfer);
-      });
+        queue.add(id, {
+          ...call,
+          args,
+          transfer: callOptions == null ? void 0 : callOptions.transfer
+        });
+        return;
+      }
+      emitDebug({ type: "commandSentToIframe", command: cmd, args });
+      pending.add(id, call);
+      pending.post(id, cmd, args, callOptions == null ? void 0 : callOptions.transfer);
+    });
+  };
+  const controller = {
+    ready: lifecycle.ready,
+    terminated: lifecycle.terminated,
+    invoke,
+    call(cmd, args, callOptions) {
+      return invoke(cmd, args, callOptions);
     },
     onNotificationFromIframe(event, handler) {
       return notifyRegistry.register(
@@ -367,6 +371,7 @@ function createIframeCallController(options) {
       }
     },
     async dispose(reason = "host_requested") {
+      var _a2;
       if (lifecycle.isTerminated()) {
         lifecycle.cleanup();
         return;
@@ -384,7 +389,7 @@ function createIframeCallController(options) {
           targetOrigin
         );
       } catch (error) {
-        options.logger?.warn("iframecall dispose message failed.", error);
+        (_a2 = options.logger) == null ? void 0 : _a2.warn("iframecall dispose message failed.", error);
       } finally {
         lifecycle.terminate(lifecycleError);
         lifecycle.cleanup();
@@ -393,6 +398,14 @@ function createIframeCallController(options) {
   };
   return controller;
 }
+function createDefaultRequestId() {
+  const bytes = crypto.getRandomValues(new Uint8Array(16));
+  let id = "";
+  for (const byte of bytes) {
+    id += byte.toString(16).padStart(2, "0");
+  }
+  return id;
+}
 function createTransportRouter(deps) {
   const {
     lifecycle,
@@ -411,7 +424,7 @@ function createTransportRouter(deps) {
       return;
     }
     const parsed = parseIframeCallMessage(event.data);
-    if (parsed?.type === "response") {
+    if ((parsed == null ? void 0 : parsed.type) === "response") {
       const responseMessage = parsed.message;
       const command = pending.getCommand(responseMessage.id);
       pending.settle(responseMessage.id, responseMessage);
@@ -432,7 +445,7 @@ function createTransportRouter(deps) {
       }
       return;
     }
-    if (parsed?.type !== "notify") return;
+    if ((parsed == null ? void 0 : parsed.type) !== "notify") return;
     const { event: notifyEvent, payload } = parsed.message;
     if (notifyEvent === "ready") {
       handleReadyNotify(payload, lifecycle, queue, pending, logger, emitDebug);
@@ -445,7 +458,7 @@ function createTransportRouter(deps) {
       emitDebug({
         type: "terminatedReceived",
         reason,
-        error: cause ?? null
+        error: cause != null ? cause : null
       });
       lifecycle.terminate(
         createIframeCallError("terminated", "Iframe terminated.", {
@@ -465,7 +478,7 @@ function createTransportRouter(deps) {
 }
 function handleReadyNotify(payload, lifecycle, queue, pending, logger, emitDebug) {
   if (lifecycle.isReady()) {
-    logger?.warn("iframecall duplicate ready ignored.", payload);
+    logger == null ? void 0 : logger.warn("iframecall duplicate ready ignored.", payload);
     return;
   }
   if (!isSupportedReadyPayload(payload)) {

package/dist/iframe.d.ts

@@ -1,5 +1,5 @@
-import { x as IframeDebugEvent, C as CommandMap, y as IframeCallRunnerOptions, z as IframeCallRunnerHandle, A as CommandsConstructor, B as IframeCallRunnerClassOptions, D as IframeHelper } from './messages-BuRipoIx.js';
-export { b as CommandArgs, c as CommandHandler, d as CommandResult, e as CommandRunner, E as DomainNotificationKey, f as IframeCallCallOptions, g as IframeCallLogger, h as IframeCallNotify, i as IframeCallRequest, j as IframeCallResponse, k as IframeCallTransferable, l as IframeCallTransport, m as IframeCallTransportEvent, N as NotifyHandler, P as ParsedIframeCallMessage, R as ReadyPolicy, n as ReservedNotificationName, S as SerializedIframeCallError, o as createIframeCallError, p as createIframeCallErrorResponse, q as createIframeCallNotify, r as createIframeCallRequest, s as createIframeCallSuccessResponse, F as createParentWindowTransport, u as isSerializedIframeCallError, v as parseIframeCallMessage, w as serializeIframeCallError } from './messages-BuRipoIx.js';
+import { x as IframeDebugEvent, C as CommandMap, y as IframeCallRunnerOptions, z as IframeCallRunnerHandle, A as CommandsConstructor, B as IframeCallRunnerClassOptions, D as IframeHelper } from './messages-uOmcU6eT.js';
+export { b as CommandArgs, c as CommandHandler, d as CommandResult, e as CommandRunner, E as DomainNotificationKey, f as IframeCallCallOptions, g as IframeCallLogger, h as IframeCallNotify, i as IframeCallRequest, j as IframeCallResponse, k as IframeCallTransferable, l as IframeCallTransport, m as IframeCallTransportEvent, N as NotifyHandler, P as ParsedIframeCallMessage, R as ReadyPolicy, n as ReservedNotificationName, S as SerializedIframeCallError, o as createIframeCallError, p as createIframeCallErrorResponse, q as createIframeCallNotify, r as createIframeCallRequest, s as createIframeCallSuccessResponse, F as createParentWindowTransport, u as isSerializedIframeCallError, v as parseIframeCallMessage, w as serializeIframeCallError } from './messages-uOmcU6eT.js';
 
 /** consoleDebugLogger 옵션. prefix를 명시하지 않으면 [iframecall:iframe]가 기본값이다. */
 type ConsoleDebugLoggerOptions = {

package/dist/iframe.js

@@ -8,11 +8,12 @@ import {
   isSerializedIframeCallError,
   parseIframeCallMessage,
   serializeIframeCallError
-} from "./chunk-UYZXYOI6.js";
+} from "./chunk-RSUK22E2.js";
 
 // src/iframe/consoleDebugLogger.ts
 function consoleDebugLogger(options = {}) {
-  const prefix = options.prefix ?? "[iframecall:iframe]";
+  var _a;
+  const prefix = (_a = options.prefix) != null ? _a : "[iframecall:iframe]";
   const head = prefix.length > 0 ? `${prefix} ` : "";
   return (event) => {
     switch (event.type) {
@@ -38,18 +39,20 @@ function consoleDebugLogger(options = {}) {
 // src/iframe/runner.ts
 var RESERVED_COMMAND_NAMES = /* @__PURE__ */ new Set(["constructor", "host:dispose"]);
 function createIframeCallRunner(options) {
+  var _a, _b;
   const targetOrigin = requireTargetOrigin(options.targetOrigin);
-  const allowedOrigins = new Set(options.allowedOrigins ?? [targetOrigin]);
-  const transport = options.transport ?? createParentWindowTransport();
+  const allowedOrigins = new Set((_a = options.allowedOrigins) != null ? _a : [targetOrigin]);
+  const transport = (_b = options.transport) != null ? _b : createParentWindowTransport();
   let disposing = false;
   let disposed = false;
   const debugSubscribers = /* @__PURE__ */ new Set();
   function emitDebug(event) {
+    var _a2;
     for (const handler of debugSubscribers) {
       try {
         handler(event);
       } catch (error) {
-        options.logger?.warn("iframecall debug subscriber threw.", error);
+        (_a2 = options.logger) == null ? void 0 : _a2.warn("iframecall debug subscriber threw.", error);
       }
     }
   }
@@ -83,7 +86,7 @@ function createIframeCallRunner(options) {
       return;
     }
     const parsed = parseIframeCallMessage(event.data);
-    if (parsed?.type === "notify") {
+    if ((parsed == null ? void 0 : parsed.type) === "notify") {
       emitDebug({
         type: "notificationReceivedFromHost",
         event: parsed.message.event,
@@ -91,7 +94,7 @@ function createIframeCallRunner(options) {
       });
       return;
     }
-    if (parsed?.type !== "request") {
+    if ((parsed == null ? void 0 : parsed.type) !== "request") {
       return;
     }
     if (parsed.message.cmd === "host:dispose") {
@@ -105,19 +108,21 @@ function createIframeCallRunner(options) {
     );
   });
   function safePost(message, transfer) {
+    var _a2;
     try {
       transport.post(message, targetOrigin, transfer);
     } catch (error) {
-      options.logger?.warn("iframecall postMessage failed.", error);
+      (_a2 = options.logger) == null ? void 0 : _a2.warn("iframecall postMessage failed.", error);
     }
   }
   async function handleHostDispose(reason) {
+    var _a2, _b2;
     if (disposing || disposed) return;
     disposing = true;
     try {
-      await options.onHostDispose?.(reason);
+      await ((_a2 = options.onHostDispose) == null ? void 0 : _a2.call(options, reason));
     } catch (error) {
-      options.logger?.warn("iframecall host dispose handler failed.", error);
+      (_b2 = options.logger) == null ? void 0 : _b2.warn("iframecall host dispose handler failed.", error);
     } finally {
       safePost(createIframeCallNotify("terminated", { reason }));
       disposed = true;
@@ -260,6 +265,7 @@ function getDisposeReason(payload) {
 // src/iframe/useIframeCallRunner.tsx
 import { useEffect, useRef, useState } from "react";
 function useIframeCallRunner(options) {
+  var _a, _b;
   const optionsRef = useRef(options);
   optionsRef.current = options;
   const runnerRef = useRef(null);
@@ -293,8 +299,8 @@ function useIframeCallRunner(options) {
   }, []);
   const runner = runnerRef.current;
   return {
-    commands: runner?.commands ?? null,
-    iframeHelper: runner?.iframeHelper ?? null,
+    commands: (_a = runner == null ? void 0 : runner.commands) != null ? _a : null,
+    iframeHelper: (_b = runner == null ? void 0 : runner.iframeHelper) != null ? _b : null,
     isActive
   };
 }

package/dist/{messages-BuRipoIx.d.ts → messages-uOmcU6eT.d.ts}

@@ -107,7 +107,7 @@ type IframeCallControllerOptions<TCommands extends CommandMap<TCommands>> = {
     readonly readyPolicy?: ReadyPolicy;
     /** queue 정책일 때 대기열 최대 크기. 초과 호출은 queue_overflow 에러로 거부한다. */
     readonly readyQueueLimit?: number;
-    /** call() 호출별 timeout 기본값(ms). 0 또는 Infinity면 timeout을 적용하지 않는다. */
+    /** invoke() 호출별 timeout 기본값(ms). 0 또는 Infinity면 timeout을 적용하지 않는다. */
     readonly defaultTimeoutMs?: number;
     /** ready 신호 대기 timeout(ms). 미지정이면 defaultTimeoutMs를 따른다. */
     readonly readyTimeoutMs?: number;
@@ -230,10 +230,12 @@ type IframeCallController<TCommands extends CommandMap<TCommands>, TNotification
     /** 종료 사유를 노출하는 promise. 정상 dispose면 null, 비정상 종료면 직렬화된 에러로 resolve된다. */
     readonly terminated: Promise<SerializedIframeCallError | null>;
     /**
-     * iframe에 등록된 command를 호출한다.
-     * ready 이전 호출은 readyPolicy에 따라 queue되거나 즉시 거부된다.
-     * timeout/transfer는 호출별 options로 지정한다.
+     * iframe에 등록된 command를 실행한다.
+     * ready 이전 실행은 readyPolicy에 따라 queue되거나 즉시 거부된다.
+     * timeout/transfer는 실행별 options로 지정한다.
      */
+    invoke<K extends keyof TCommands & string>(cmd: K, args: CommandArgs<TCommands[K]>, options?: IframeCallCallOptions): Promise<CommandResult<TCommands[K]>>;
+    /** @deprecated `invoke()`를 사용한다. 다음 major release에서 제거될 예정이다. */
     call<K extends keyof TCommands & string>(cmd: K, args: CommandArgs<TCommands[K]>, options?: IframeCallCallOptions): Promise<CommandResult<TCommands[K]>>;
     /**
      * iframe이 host로 보낸 notification을 event 이름과 payload로 구독한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cp949/iframecall",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "타입 안전한 host ↔ iframe postMessage 호출 라이브러리 (React 18/19 지원)",
   "keywords": [
     "iframe",
@@ -24,6 +24,10 @@
   },
   "type": "module",
   "sideEffects": false,
+  "browserslist": [
+    "chrome 75",
+    "firefox 67"
+  ],
   "files": [
     "dist",
     "README.md",
@@ -43,25 +47,29 @@
   "publishConfig": {
     "access": "public"
   },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "@types/react": "^18.0.0 || ^19.0.0"
-  },
-  "devDependencies": {
-    "@testing-library/dom": "^10.4.0",
-    "@testing-library/react": "^16.3.0",
-    "@types/react": "19.2.2",
-    "jsdom": "^25.0.1",
-    "react": "^19.2.0",
-    "typescript": "6.0.3",
-    "tsup": "^8.0.0",
-    "vitest": "^4.1.5",
-    "@repo/typescript-config": "0.0.0"
-  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
-    "test": "vitest run tests/unit --passWithNoTests"
+    "test": "vitest run tests/unit --passWithNoTests",
+    "prepublishOnly": "pnpm run build"
+  },
+  "peerDependencies": {
+    "@types/react": "^18.0.0 || ^19.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "19.2.18",
+    "eslint": "^9.39.5",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "^4.1.11"
   }
-}
+}