request-iframe 0.1.1 → 0.2.0

package/esm/utils/iframe.js

@@ -0,0 +1,20 @@
+import "core-js/modules/es.array.iterator.js";
+import "core-js/modules/web.dom-collections.iterator.js";
+import "core-js/modules/web.url.js";
+import "core-js/modules/web.url.to-json.js";
+import "core-js/modules/web.url-search-params.js";
+import { OriginConstant } from '../constants';
+
+/**
+ * Derive targetOrigin from iframe.src
+ */
+export function getIframeTargetOrigin(iframe) {
+  if (!iframe.src) {
+    return OriginConstant.ANY;
+  }
+  try {
+    return new URL(iframe.src).origin;
+  } catch (e) {
+    return OriginConstant.ANY;
+  }
+}

package/esm/utils/index.js

@@ -1,78 +1,16 @@
-import "core-js/modules/es.array.includes.js";
-import "core-js/modules/es.array.iterator.js";
-import "core-js/modules/es.promise.js";
-import "core-js/modules/es.regexp.to-string.js";
-import "core-js/modules/es.string.includes.js";
-import "core-js/modules/web.dom-collections.iterator.js";
-import "core-js/modules/web.url.js";
-import "core-js/modules/web.url.to-json.js";
-import "core-js/modules/web.url-search-params.js";
-import { OriginConstant } from '../constants';
-
-/**
- * Generate unique request ID
- */
-export function generateRequestId() {
-  return `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
-}
-
-/**
- * Generate unique instance ID
- */
-export function generateInstanceId() {
-  return `inst_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
-}
-
-/**
- * Derive targetOrigin from iframe.src
- */
-export function getIframeTargetOrigin(iframe) {
-  if (!iframe.src) {
-    return OriginConstant.ANY;
-  }
-  try {
-    return new URL(iframe.src).origin;
-  } catch (e) {
-    return OriginConstant.ANY;
-  }
-}
-export function isPromise(value) {
-  return value !== null && typeof value === 'object' && 'then' in value;
-}
-
-/**
- * Check if target window is still available (not closed/removed)
- * @param targetWindow Target window to check
- * @returns true if window is available, false otherwise
- */
-export function isWindowAvailable(targetWindow) {
-  if (!targetWindow) {
-    return false;
-  }
-  try {
-    // Must have postMessage to be a usable target
-    if (typeof targetWindow.postMessage !== 'function') {
-      return false;
-    }
-
-    // For windows opened via window.open(), check closed property
-    if ('closed' in targetWindow && targetWindow.closed === true) {
-      return false;
-    }
-
-    // Avoid touching cross-origin properties (like document) which may throw.
-    // If closed is not true and postMessage exists, treat as available.
-    return true;
-  } catch (e) {
-    // If accessing window properties throws an error, window is likely closed
-    return false;
-  }
-}
+export { generateRequestId, generateInstanceId } from './id';
+export { getIframeTargetOrigin } from './iframe';
+export { isPromise } from './promise';
+export { isFunction } from './is';
+export { isWindowAvailable } from './window';
+export { detectContentType } from './content-type';
 // Export protocol-related functions
 export { createPostMessage, isValidPostMessage, validatePostMessage, validateProtocolVersion, isRequestIframeMessage, getProtocolVersion, isCompatibleVersion } from './protocol';
 
-// Export cache-related functions
-export * from './cache';
+// NOTE:
+// Cache helpers are intentionally NOT re-exported here.
+// - Server cache is an internal API and should be imported from `./cache` explicitly.
+// - MessageChannel cache lives in `src/message/channel-cache.ts`.
 
 // Export path matching functions
 export * from './path-match';
@@ -87,94 +25,4 @@ export * from './cookie';
 
 // Export Error class
 export { RequestIframeError } from './error';
-
-/**
- * Detect Content-Type based on data type
- * @param data The data to detect Content-Type for
- * @param options Options for detection
- * @param options.checkStream Whether to check for IframeWritableStream (default: false)
- * @param options.isIframeWritableStream Optional function to check if data is a stream (required if checkStream is true)
- * @returns The detected Content-Type, or null if Content-Type should not be auto-set
- */
-export function detectContentType(data, options) {
-  if (data === null || data === undefined) return null;
-  var _ref = options || {},
-    _ref$checkStream = _ref.checkStream,
-    checkStream = _ref$checkStream === void 0 ? false : _ref$checkStream,
-    isIframeWritableStream = _ref.isIframeWritableStream;
-
-  // Stream - handled separately (only for response)
-  if (checkStream && isIframeWritableStream) {
-    if (isIframeWritableStream(data)) {
-      return null; // Stream will be handled by sendStream
-    }
-  }
-
-  // File
-  if (typeof File !== 'undefined' && data instanceof File) {
-    return data.type || 'application/octet-stream';
-  }
-
-  // Blob
-  if (typeof Blob !== 'undefined' && data instanceof Blob) {
-    return data.type || 'application/octet-stream';
-  }
-
-  // ArrayBuffer
-  if (typeof ArrayBuffer !== 'undefined' && data instanceof ArrayBuffer) {
-    return 'application/octet-stream';
-  }
-
-  // FormData
-  if (typeof FormData !== 'undefined' && data instanceof FormData) {
-    // FormData typically doesn't need Content-Type header (browser sets it with boundary)
-    return null;
-  }
-
-  // URLSearchParams
-  if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) {
-    return 'application/x-www-form-urlencoded';
-  }
-
-  // String - check if it's JSON string
-  if (typeof data === 'string') {
-    // Try to parse as JSON, if successful, treat as JSON
-    try {
-      JSON.parse(data);
-      return 'application/json';
-    } catch (_unused) {
-      return 'text/plain; charset=utf-8';
-    }
-  }
-
-  // Number, boolean - treat as JSON
-  if (typeof data === 'number' || typeof data === 'boolean') {
-    return 'application/json';
-  }
-
-  // Plain object or array - treat as JSON
-  if (typeof data === 'object') {
-    // Exclude common binary/file types (already checked above, but double-check for safety)
-    if (typeof Blob !== 'undefined' && data instanceof Blob) return null;
-    if (typeof File !== 'undefined' && data instanceof File) return null;
-    if (typeof ArrayBuffer !== 'undefined' && data instanceof ArrayBuffer) return null;
-    if (typeof FormData !== 'undefined' && data instanceof FormData) return null;
-    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) return null;
-    return 'application/json';
-  }
-  return null;
-}
-
-/** Convert Blob to base64 string */
-export function blobToBase64(blob) {
-  return new Promise((resolve, reject) => {
-    var reader = new FileReader();
-    reader.onloadend = () => {
-      var result = reader.result;
-      var base64 = result.includes(',') ? result.split(',')[1] : result;
-      resolve(base64);
-    };
-    reader.onerror = reject;
-    reader.readAsDataURL(blob);
-  });
-}
+export { blobToBase64 } from './blob';

package/esm/utils/is.js

@@ -0,0 +1,3 @@
+export function isFunction(value) {
+  return typeof value === 'function';
+}

package/esm/utils/logger.js

@@ -0,0 +1,55 @@
+import { LogLevel } from '../constants';
+
+/**
+ * Built-in leveled logger for request-iframe.
+ *
+ * - Default level is 'warn' (prints warn/error only)
+ * - Trace/debug tools can raise to 'info' or 'trace'
+ */
+
+var DEBUG_PREFIX = '[request-iframe]';
+var levelOrder = {
+  [LogLevel.TRACE]: 10,
+  [LogLevel.INFO]: 20,
+  [LogLevel.WARN]: 30,
+  [LogLevel.ERROR]: 40,
+  [LogLevel.SILENT]: 100
+};
+var currentLevel = LogLevel.WARN;
+export function getRequestIframeLogLevel() {
+  return currentLevel;
+}
+export function setRequestIframeLogLevel(level) {
+  currentLevel = level;
+}
+
+/**
+ * Ensure current log level is at least as verbose as `level`.
+ * - Example: current 'warn' + ensure 'trace' => becomes 'trace'
+ */
+export function ensureRequestIframeLogLevel(level) {
+  if (levelOrder[level] < levelOrder[currentLevel]) {
+    currentLevel = level;
+  }
+}
+function shouldLog(level) {
+  return levelOrder[level] >= levelOrder[currentLevel];
+}
+
+/**
+ * Log with level gating + unified prefix.
+ */
+export function requestIframeLog(level, message, data) {
+  if (currentLevel === LogLevel.SILENT) return;
+  if (!shouldLog(level)) return;
+  var timestamp = new Date().toISOString();
+  var prefix = `${DEBUG_PREFIX} [${timestamp}] [${level.toUpperCase()}]`;
+  var prefixStyle = 'font-weight:bold';
+  var messageStyle = level === LogLevel.INFO ? 'color: #1976d2' : '';
+  var method = level === LogLevel.TRACE ? 'debug' : level;
+  if (data !== undefined) {
+    console[method](`%c${prefix}%c ${message}`, prefixStyle, messageStyle, data);
+  } else {
+    console[method](`%c${prefix}%c ${message}`, prefixStyle, messageStyle);
+  }
+}

package/esm/utils/promise.js

@@ -0,0 +1,3 @@
+export function isPromise(value) {
+  return value !== null && typeof value === 'object' && 'then' in value;
+}

package/esm/utils/window.js

@@ -0,0 +1,31 @@
+/**
+ * Check if target window is still available (not closed/removed)
+ * @param targetWindow Target window to check
+ * @returns true if window is available, false otherwise
+ */
+import { isFunction } from './is';
+export function isWindowAvailable(targetWindow) {
+  if (!targetWindow) {
+    return false;
+  }
+  try {
+    /** Must have postMessage to be a usable target */
+    if (!isFunction(targetWindow.postMessage)) {
+      return false;
+    }
+
+    /** For windows opened via window.open(), check closed property */
+    if ('closed' in targetWindow && targetWindow.closed === true) {
+      return false;
+    }
+
+    /**
+     * Avoid touching cross-origin properties (like document) which may throw.
+     * If closed is not true and postMessage exists, treat as available.
+     */
+    return true;
+  } catch (e) {
+    /** If accessing window properties throws an error, window is likely closed */
+    return false;
+  }
+}

package/library/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAO1F;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CAwDrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKtE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAS1F;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CA2DrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAQtE"}

package/library/api/client.js

@@ -5,11 +5,13 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.clearRequestIframeClientCache = clearRequestIframeClientCache;
 exports.requestIframeClient = requestIframeClient;
-var _utils = require("../utils");
-var _clientServer = require("../core/client-server");
-var _client = require("../core/client");
+var _iframe = require("../utils/iframe");
+var _id = require("../utils/id");
+var _client = require("../impl/client");
 var _debug = require("../utils/debug");
+var _logger = require("../utils/logger");
 var _constants = require("../constants");
+var _channelCache = require("../message/channel-cache");
 /**
  * Create a client (for sending requests)
  * 
@@ -24,7 +26,7 @@ function requestIframeClient(target, options) {
   if (target.tagName === 'IFRAME') {
     var iframe = target;
     targetWindow = iframe.contentWindow;
-    targetOrigin = (0, _utils.getIframeTargetOrigin)(iframe);
+    targetOrigin = (0, _iframe.getIframeTargetOrigin)(iframe);
     if (!targetWindow) {
       throw {
         message: _constants.Messages.IFRAME_NOT_READY,
@@ -45,18 +47,10 @@ function requestIframeClient(target, options) {
   var secretKey = options === null || options === void 0 ? void 0 : options.secretKey;
 
   // Generate instance ID first (will be used by both client and server)
-  var instanceId = (0, _utils.generateInstanceId)();
+  var instanceId = (0, _id.generateInstanceId)();
 
-  // Create ClientServer (internally obtains or creates a shared MessageChannel)
-  var server = new _clientServer.RequestIframeClientServer({
-    secretKey,
-    autoOpen: options === null || options === void 0 ? void 0 : options.autoOpen,
-    autoAckMaxMetaLength: options === null || options === void 0 ? void 0 : options.autoAckMaxMetaLength,
-    autoAckMaxIdLength: options === null || options === void 0 ? void 0 : options.autoAckMaxIdLength
-  }, instanceId);
-
-  // Create client instance
-  var client = new _client.RequestIframeClientImpl(targetWindow, targetOrigin, server, {
+  // Create client instance (internally creates its core message server)
+  var client = new _client.RequestIframeClientImpl(targetWindow, targetOrigin, {
     secretKey,
     ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
     timeout: options === null || options === void 0 ? void 0 : options.timeout,
@@ -64,12 +58,23 @@ function requestIframeClient(target, options) {
     returnData: options === null || options === void 0 ? void 0 : options.returnData,
     headers: options === null || options === void 0 ? void 0 : options.headers,
     allowedOrigins: options === null || options === void 0 ? void 0 : options.allowedOrigins,
-    validateOrigin: options === null || options === void 0 ? void 0 : options.validateOrigin
+    validateOrigin: options === null || options === void 0 ? void 0 : options.validateOrigin,
+    autoOpen: options === null || options === void 0 ? void 0 : options.autoOpen,
+    autoAckMaxMetaLength: options === null || options === void 0 ? void 0 : options.autoAckMaxMetaLength,
+    autoAckMaxIdLength: options === null || options === void 0 ? void 0 : options.autoAckMaxIdLength
   }, instanceId);
 
-  // If trace mode is enabled, register debug interceptors
+  /**
+   * Trace/log level:
+   * - default: only warn/error will be printed (logger default)
+   * - if trace enabled: raise log level and (optionally) enable detailed debug interceptors
+   */
   if (options !== null && options !== void 0 && options.trace) {
-    (0, _debug.setupClientDebugInterceptors)(client);
+    var level = options.trace === true ? _constants.LogLevel.TRACE : options.trace;
+    (0, _logger.setRequestIframeLogLevel)(level);
+    if (level === _constants.LogLevel.TRACE || level === _constants.LogLevel.INFO) {
+      (0, _debug.setupClientDebugInterceptors)(client);
+    }
   }
   return client;
 }
@@ -79,8 +84,11 @@ function requestIframeClient(target, options) {
  * Note: This clears the shared message channel for the specified secretKey
  */
 function clearRequestIframeClientCache(secretKey) {
-  // Now client is no longer cached, only need to clear MessageChannel cache
-  // MessageChannel cleanup is handled by clearMessageChannelCache in cache.ts
-  // Empty implementation kept here to maintain API compatibility
-  void secretKey;
+  // Client is not cached; this helper only clears shared MessageChannel cache.
+  // If secretKey is provided, only clear channels under that secretKey.
+  if (typeof secretKey === 'string') {
+    (0, _channelCache.clearMessageChannelCache)(secretKey);
+    return;
+  }
+  (0, _channelCache.clearMessageChannelCache)();
 }

package/library/api/endpoint.d.ts

@@ -0,0 +1,23 @@
+import type { RequestIframeClient, RequestIframeServer, RequestIframeClientOptions, RequestIframeServerOptions } from '../types';
+/**
+ * Endpoint facade type (client + server).
+ */
+export type RequestIframeEndpoint = RequestIframeClient & RequestIframeServer;
+/**
+ * Endpoint facade options (client + server).
+ *
+ * - For client-side sending: uses RequestIframeClientOptions fields (targetOrigin, headers, etc.)
+ * - For server-side handling: uses RequestIframeServerOptions fields (middlewares, allowedOrigins, etc.)
+ *
+ * Note: overlapping fields (autoOpen/trace/allowedOrigins/validateOrigin/ackTimeout/autoAckMax*) apply to both sides.
+ */
+export type RequestIframeEndpointOptions = RequestIframeClientOptions & RequestIframeServerOptions;
+/**
+ * Create an endpoint facade (client + server) for a peer window/iframe.
+ *
+ * It can:
+ * - send requests to the peer (client)
+ * - handle requests from the peer (server)
+ */
+export declare function requestIframeEndpoint(target: HTMLIFrameElement | Window, options?: RequestIframeEndpointOptions): RequestIframeEndpoint;
+//# sourceMappingURL=endpoint.d.ts.map

package/library/api/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/api/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AAUlB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG,0BAA0B,CAAC;AA8LnG;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,4BAA4B,GACrC,qBAAqB,CAoCvB"}

package/library/api/endpoint.js

@@ -0,0 +1,235 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.requestIframeEndpoint = requestIframeEndpoint;
+require("core-js/modules/es.array.map.js");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _iframe = require("../utils/iframe");
+var _id = require("../utils/id");
+var _window = require("../utils/window");
+var _client = require("../impl/client");
+var _server = require("../impl/server");
+var _debug = require("../utils/debug");
+var _logger = require("../utils/logger");
+var _constants = require("../constants");
+/**
+ * Endpoint facade type (client + server).
+ */
+
+/**
+ * Endpoint facade options (client + server).
+ *
+ * - For client-side sending: uses RequestIframeClientOptions fields (targetOrigin, headers, etc.)
+ * - For server-side handling: uses RequestIframeServerOptions fields (middlewares, allowedOrigins, etc.)
+ *
+ * Note: overlapping fields (autoOpen/trace/allowedOrigins/validateOrigin/ackTimeout/autoAckMax*) apply to both sides.
+ */
+
+class RequestIframeEndpointApiFacade {
+  constructor(params) {
+    var _params$options;
+    (0, _defineProperty2.default)(this, "desiredOpen_", true);
+    /** Client send APIs */
+    (0, _defineProperty2.default)(this, "send", (path, body, options) => this.getClient().send(path, body, options));
+    (0, _defineProperty2.default)(this, "sendFile", (path, content, options) => this.getClient().sendFile(path, content, options));
+    (0, _defineProperty2.default)(this, "sendStream", (path, stream, options) => this.getClient().sendStream(path, stream, options));
+    (0, _defineProperty2.default)(this, "isConnect", () => this.getClient().isConnect());
+    (0, _defineProperty2.default)(this, "getCookies", path => this.getClient().getCookies(path));
+    (0, _defineProperty2.default)(this, "getCookie", (name, path) => this.getClient().getCookie(name, path));
+    (0, _defineProperty2.default)(this, "setCookie", (name, value, options) => this.getClient().setCookie(name, value, options));
+    (0, _defineProperty2.default)(this, "removeCookie", (name, path) => this.getClient().removeCookie(name, path));
+    (0, _defineProperty2.default)(this, "clearCookies", () => this.getClient().clearCookies());
+    /** Server routing/middleware APIs */
+    (0, _defineProperty2.default)(this, "use", (pathOrMiddleware, middleware) => this.getServer().use(pathOrMiddleware, middleware));
+    (0, _defineProperty2.default)(this, "on", (path, handler) => this.getServer().on(path, handler));
+    (0, _defineProperty2.default)(this, "off", path => this.getServer().off(path));
+    (0, _defineProperty2.default)(this, "map", handlers => this.getServer().map(handlers));
+    this.targetWindow_ = params.targetWindow;
+    this.targetOrigin_ = params.targetOrigin;
+    this.options_ = params.options;
+    this.endpointId_ = params.endpointId;
+    this.desiredOpen_ = ((_params$options = params.options) === null || _params$options === void 0 ? void 0 : _params$options.autoOpen) !== false;
+  }
+
+  /**
+   * Lazy create client.
+   */
+  getClient() {
+    if (!this.client_) {
+      var options = this.options_;
+      var client = new _client.RequestIframeClientImpl(this.targetWindow_, this.targetOrigin_, {
+        secretKey: options === null || options === void 0 ? void 0 : options.secretKey,
+        ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
+        timeout: options === null || options === void 0 ? void 0 : options.timeout,
+        asyncTimeout: options === null || options === void 0 ? void 0 : options.asyncTimeout,
+        returnData: options === null || options === void 0 ? void 0 : options.returnData,
+        headers: options === null || options === void 0 ? void 0 : options.headers,
+        allowedOrigins: options === null || options === void 0 ? void 0 : options.allowedOrigins,
+        validateOrigin: options === null || options === void 0 ? void 0 : options.validateOrigin,
+        autoOpen: false,
+        autoAckMaxMetaLength: options === null || options === void 0 ? void 0 : options.autoAckMaxMetaLength,
+        autoAckMaxIdLength: options === null || options === void 0 ? void 0 : options.autoAckMaxIdLength
+      }, this.endpointId_);
+      if (options !== null && options !== void 0 && options.trace) {
+        var level = options.trace === true ? _constants.LogLevel.TRACE : options.trace;
+        (0, _logger.setRequestIframeLogLevel)(level);
+        if (level === _constants.LogLevel.TRACE || level === _constants.LogLevel.INFO) {
+          (0, _debug.setupClientDebugInterceptors)(client);
+        }
+      }
+      this.client_ = client;
+    }
+    if (this.desiredOpen_ && !this.client_.isOpen) {
+      this.client_.open();
+    }
+    if (!this.desiredOpen_ && this.client_.isOpen) {
+      this.client_.close();
+    }
+    return this.client_;
+  }
+
+  /**
+   * Lazy create server.
+   */
+  getServer() {
+    if (!this.server_) {
+      var options = this.options_;
+      var server = new _server.RequestIframeServerImpl({
+        secretKey: options === null || options === void 0 ? void 0 : options.secretKey,
+        id: this.endpointId_,
+        ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
+        autoOpen: false,
+        allowedOrigins: options === null || options === void 0 ? void 0 : options.allowedOrigins,
+        validateOrigin: options === null || options === void 0 ? void 0 : options.validateOrigin,
+        maxConcurrentRequestsPerClient: options === null || options === void 0 ? void 0 : options.maxConcurrentRequestsPerClient,
+        autoAckMaxMetaLength: options === null || options === void 0 ? void 0 : options.autoAckMaxMetaLength,
+        autoAckMaxIdLength: options === null || options === void 0 ? void 0 : options.autoAckMaxIdLength
+      });
+      if (options !== null && options !== void 0 && options.trace) {
+        var level = options.trace === true ? _constants.LogLevel.TRACE : options.trace;
+        (0, _logger.setRequestIframeLogLevel)(level);
+        if (level === _constants.LogLevel.TRACE || level === _constants.LogLevel.INFO) {
+          (0, _debug.setupServerDebugListeners)(server);
+        }
+      }
+      this.server_ = server;
+    }
+    if (this.desiredOpen_ && !this.server_.isOpen) {
+      this.server_.open();
+    }
+    if (!this.desiredOpen_ && this.server_.isOpen) {
+      this.server_.close();
+    }
+    return this.server_;
+  }
+
+  /**
+   * Optional accessors for debugging.
+   * Note: accessing will trigger lazy creation.
+   */
+  get client() {
+    return this.getClient();
+  }
+  get server() {
+    return this.getServer();
+  }
+
+  /** Client fields */
+  get targetWindow() {
+    return this.targetWindow_;
+  }
+  get id() {
+    return this.endpointId_;
+  }
+  get isOpen() {
+    /**
+     * Facade-level open state.
+     * - When client/server is lazily created later, it will follow this state.
+     */
+    return this.desiredOpen_;
+  }
+  get interceptors() {
+    return this.getClient().interceptors;
+  }
+  set interceptors(value) {
+    this.getClient().interceptors = value;
+  }
+  isAvailable() {
+    return (0, _window.isWindowAvailable)(this.targetWindow_);
+  }
+  open() {
+    var _this$client_, _this$server_;
+    this.desiredOpen_ = true;
+    (_this$client_ = this.client_) === null || _this$client_ === void 0 || _this$client_.open();
+    (_this$server_ = this.server_) === null || _this$server_ === void 0 || _this$server_.open();
+  }
+  close() {
+    var _this$client_2, _this$server_2;
+    this.desiredOpen_ = false;
+    (_this$client_2 = this.client_) === null || _this$client_2 === void 0 || _this$client_2.close();
+    (_this$server_2 = this.server_) === null || _this$server_2 === void 0 || _this$server_2.close();
+  }
+  destroy() {
+    var _this$client_3, _this$server_3;
+    /**
+     * Destroy created sides only.
+     * They share the underlying MessageChannel via cache ref-counting, so partial creation is safe.
+     */
+    (_this$client_3 = this.client_) === null || _this$client_3 === void 0 || _this$client_3.destroy();
+    (_this$server_3 = this.server_) === null || _this$server_3 === void 0 || _this$server_3.destroy();
+    this.client_ = undefined;
+    this.server_ = undefined;
+  }
+  /** Server fields */
+  get secretKey() {
+    var _this$options_;
+    return (_this$options_ = this.options_) === null || _this$options_ === void 0 ? void 0 : _this$options_.secretKey;
+  }
+}
+
+/**
+ * Create an endpoint facade (client + server) for a peer window/iframe.
+ *
+ * It can:
+ * - send requests to the peer (client)
+ * - handle requests from the peer (server)
+ */
+function requestIframeEndpoint(target, options) {
+  var _options$id;
+  var targetWindow = null;
+  var targetOrigin = _constants.OriginConstant.ANY;
+  if (target.tagName === 'IFRAME') {
+    var iframe = target;
+    targetWindow = iframe.contentWindow;
+    targetOrigin = (0, _iframe.getIframeTargetOrigin)(iframe);
+    if (!targetWindow) {
+      throw {
+        message: _constants.Messages.IFRAME_NOT_READY,
+        code: _constants.ErrorCode.IFRAME_NOT_READY
+      };
+    }
+  } else {
+    targetWindow = target;
+    targetOrigin = _constants.OriginConstant.ANY;
+  }
+
+  /** Allow user to override targetOrigin explicitly */
+  if (options !== null && options !== void 0 && options.targetOrigin) {
+    targetOrigin = options.targetOrigin;
+  }
+
+  /**
+   * Endpoint uses ONE shared id by default, so it behaves like a single endpoint.
+   * If options.id is provided, it becomes the shared id for both client+server.
+   */
+  var endpointId = (_options$id = options === null || options === void 0 ? void 0 : options.id) !== null && _options$id !== void 0 ? _options$id : (0, _id.generateInstanceId)();
+  return new RequestIframeEndpointApiFacade({
+    targetWindow,
+    targetOrigin,
+    options,
+    endpointId
+  });
+}

package/library/api/server.d.ts

@@ -13,5 +13,8 @@ export declare function requestIframeServer(options?: RequestIframeServerOptions
  * Clear server cache (for testing or reset)
  * Note: This clears the cached server instances
  */
-export declare function clearRequestIframeServerCache(secretKey?: string): void;
+export declare function clearRequestIframeServerCache(arg?: string | {
+    secretKey?: string;
+    id?: string;
+}): void;
 //# sourceMappingURL=server.d.ts.map