request-iframe 0.0.6 → 0.1.1

package/esm/core/client.js

@@ -0,0 +1,873 @@
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.array.filter.js";
+import "core-js/modules/es.array.from.js";
+import "core-js/modules/es.array.iterator.js";
+import "core-js/modules/es.array.slice.js";
+import "core-js/modules/es.map.js";
+import "core-js/modules/es.object.entries.js";
+import "core-js/modules/es.promise.js";
+import "core-js/modules/es.object.get-own-property-descriptors.js";
+import "core-js/modules/es.regexp.exec.js";
+import "core-js/modules/es.regexp.to-string.js";
+import "core-js/modules/es.string.match.js";
+import "core-js/modules/es.string.replace.js";
+import "core-js/modules/es.string.starts-with.js";
+import "core-js/modules/web.dom-collections.for-each.js";
+import "core-js/modules/web.dom-collections.iterator.js";
+import { RequestIframeError } from '../utils';
+import { isAckMatch } from '../utils/ack';
+import { detectContentType, blobToBase64, isWindowAvailable, matchOrigin } from '../utils';
+import { generateRequestId, generateInstanceId, CookieStore } from '../utils';
+import { RequestInterceptorManager, ResponseInterceptorManager, runRequestInterceptors, runResponseInterceptors } from '../interceptors';
+import { DefaultTimeout, ErrorCode, MessageType, OriginConstant, HttpStatus, HttpStatusText, HttpHeader, Messages, formatMessage, StreamType as StreamTypeConstant } from '../constants';
+import { IframeReadableStream, IframeFileReadableStream, isIframeWritableStream } from '../stream';
+
+/**
+ * Client configuration options
+ */
+
+/**
+ * RequestIframeClient implementation (only responsible for initiating requests, reuses server's listener)
+ */
+export class RequestIframeClientImpl {
+  /** 
+   * Target server ID (remembered from responses)
+   * When a response is received, we remember the server's creatorId as the targetId for future requests
+   */
+
+  constructor(targetWindow, targetOrigin, server, options, instanceId) {
+    var _options$ackTimeout, _options$timeout, _options$asyncTimeout, _options$returnData;
+    /** Unique instance ID */
+    _defineProperty(this, "interceptors", {
+      request: new RequestInterceptorManager(),
+      response: new ResponseInterceptorManager()
+    });
+    /** 
+     * Internal cookies storage
+     * - Automatically includes cookies matching the path when sending requests
+     * - Automatically parses Set-Cookie and saves when receiving response
+     */
+    _defineProperty(this, "_cookieStore", new CookieStore());
+    /** 
+     * Stream message handler map
+     * key: streamId
+     * value: stream message handler function
+     */
+    _defineProperty(this, "streamHandlers", new Map());
+    this.id = instanceId || generateInstanceId();
+    this.targetWindow = targetWindow;
+    this.targetOrigin = targetOrigin;
+    this.server = server;
+    this.secretKey = options === null || options === void 0 ? void 0 : options.secretKey;
+
+    // Provide fallback target for auto-ack (useful when MessageEvent.source is missing in tests)
+    this.server.messageDispatcher.setFallbackTarget(this.targetWindow, this.targetOrigin);
+
+    // Build origin validator (incoming messages)
+    if (options !== null && options !== void 0 && options.validateOrigin) {
+      this.originValidator = (origin, data, context) => options.validateOrigin(origin, data, context);
+    } else if (options !== null && options !== void 0 && options.allowedOrigins) {
+      var matcher = options.allowedOrigins;
+      this.originValidator = origin => matchOrigin(origin, matcher);
+    }
+
+    // Set default timeout configuration
+    this.defaultAckTimeout = (_options$ackTimeout = options === null || options === void 0 ? void 0 : options.ackTimeout) !== null && _options$ackTimeout !== void 0 ? _options$ackTimeout : DefaultTimeout.ACK;
+    this.defaultTimeout = (_options$timeout = options === null || options === void 0 ? void 0 : options.timeout) !== null && _options$timeout !== void 0 ? _options$timeout : DefaultTimeout.REQUEST;
+    this.defaultAsyncTimeout = (_options$asyncTimeout = options === null || options === void 0 ? void 0 : options.asyncTimeout) !== null && _options$asyncTimeout !== void 0 ? _options$asyncTimeout : DefaultTimeout.ASYNC;
+
+    // Set default returnData configuration
+    this.defaultReturnData = (_options$returnData = options === null || options === void 0 ? void 0 : options.returnData) !== null && _options$returnData !== void 0 ? _options$returnData : false;
+
+    // Save initial headers configuration
+    this.initialHeaders = options === null || options === void 0 ? void 0 : options.headers;
+
+    // Register stream message processing callback
+    this.server.setStreamCallback((data, context) => {
+      this.dispatchStreamMessage(data, context);
+    });
+  }
+
+  /**
+   * Register stream message handler (StreamMessageHandler interface implementation)
+   */
+  registerStreamHandler(streamId, handler) {
+    this.streamHandlers.set(streamId, handler);
+  }
+
+  /**
+   * Unregister stream message handler (StreamMessageHandler interface implementation)
+   */
+  unregisterStreamHandler(streamId) {
+    this.streamHandlers.delete(streamId);
+  }
+
+  /*
+   Send message (StreamMessageHandler interface implementation)
+   */
+  postMessage(message) {
+    // Window check is handled in MessageDispatcher
+    this.server.messageDispatcher.send(this.targetWindow, message, this.targetOrigin);
+  }
+
+  /**
+   * Dispatch stream message to corresponding handler
+   */
+  dispatchStreamMessage(data, context) {
+    // Validate origin for stream messages (stream_data/stream_end/stream_error/stream_cancel)
+    if (context) {
+      if (this.originValidator) {
+        try {
+          if (!this.originValidator(context.origin, data, context)) {
+            return;
+          }
+        } catch (_unused) {
+          return;
+        }
+      } else if (this.targetOrigin !== OriginConstant.ANY && context.origin !== this.targetOrigin) {
+        return;
+      }
+    }
+    var body = data.body;
+    if (!body || !body.streamId) return;
+    var handler = this.streamHandlers.get(body.streamId);
+    if (handler) {
+      if (context && !context.handledBy) {
+        context.accepted = true;
+        context.handledBy = this.id;
+      }
+      // Extract message type (remove stream_ prefix)
+      var messageType = data.type.replace('stream_', '');
+      handler(_objectSpread(_objectSpread({}, body), {}, {
+        type: messageType
+      }));
+    }
+  }
+
+  /**
+   * Resolve header value (handle function type headers)
+   */
+  resolveHeaderValue(value, config) {
+    if (typeof value === 'function') {
+      return value(config);
+    }
+    return value;
+  }
+
+  /**
+   * Detect Content-Type for request body
+   */
+  detectContentTypeForBody(body) {
+    return detectContentType(body, {
+      checkStream: false
+    });
+  }
+
+  /**
+   * Check if header exists (case-insensitive)
+   */
+  hasHeader(headers, name) {
+    var lower = name.toLowerCase();
+    return Object.keys(headers).some(k => k.toLowerCase() === lower);
+  }
+
+  /**
+   * Merge and resolve headers (initial headers + request headers)
+   * Request headers take precedence over initial headers
+   * Also auto-detects and sets Content-Type if not already set
+   */
+  mergeHeaders(config, body) {
+    var resolvedHeaders = {};
+
+    // First, resolve initial headers
+    if (this.initialHeaders) {
+      for (var _i = 0, _Object$entries = Object.entries(this.initialHeaders); _i < _Object$entries.length; _i++) {
+        var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+          key = _Object$entries$_i[0],
+          value = _Object$entries$_i[1];
+        resolvedHeaders[key] = this.resolveHeaderValue(value, config);
+      }
+    }
+
+    // Then, merge request headers (request headers take precedence)
+    if (config.headers) {
+      for (var _i2 = 0, _Object$entries2 = Object.entries(config.headers); _i2 < _Object$entries2.length; _i2++) {
+        var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2),
+          _key = _Object$entries2$_i[0],
+          _value = _Object$entries2$_i[1];
+        resolvedHeaders[_key] = this.resolveHeaderValue(_value, config);
+      }
+    }
+
+    // Auto-detect and set Content-Type if not already set and body is provided
+    if (body !== undefined && !this.hasHeader(resolvedHeaders, HttpHeader.CONTENT_TYPE)) {
+      var contentType = this.detectContentTypeForBody(body);
+      if (contentType) {
+        resolvedHeaders[HttpHeader.CONTENT_TYPE] = contentType;
+      }
+    }
+    return resolvedHeaders;
+  }
+
+  /**
+   * Check if server is reachable
+   */
+  isConnect() {
+    return new Promise((resolve, reject) => {
+      var requestId = generateRequestId();
+      var done = false;
+      var timeoutId = null;
+      var cleanup = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        this.server._unregisterPendingRequest(requestId);
+      };
+
+      // Check if target window is still available before sending ping
+      if (!isWindowAvailable(this.targetWindow)) {
+        reject(new RequestIframeError({
+          message: Messages.TARGET_WINDOW_CLOSED,
+          code: ErrorCode.TARGET_WINDOW_CLOSED,
+          config: undefined,
+          requestId
+        }));
+        return;
+      }
+      this.server._registerPendingRequest(requestId, data => {
+        if (done) return;
+        if (data.type === MessageType.ACK || data.type === MessageType.PONG) {
+          // Remember server's creatorId as target server ID for future requests
+          if (data.creatorId && !this._targetServerId) {
+            this._targetServerId = data.creatorId;
+          }
+          done = true;
+          cleanup();
+          resolve(true);
+        }
+      }, () => {
+        if (done) return;
+        done = true;
+        cleanup();
+        resolve(false);
+      }, this.targetOrigin, this.originValidator);
+      timeoutId = setTimeout(() => {
+        if (done) return;
+        done = true;
+        cleanup();
+        resolve(false);
+      }, this.defaultAckTimeout);
+
+      // Send ping via MessageDispatcher
+      this.server.messageDispatcher.sendMessage(this.targetWindow, this.targetOrigin, MessageType.PING, requestId, {
+        requireAck: true,
+        targetId: this._targetServerId
+      });
+    });
+  }
+  send(path, body, options) {
+    var _this = this;
+    return _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var config, processedConfig, processedBody, mergedHeaders, processedPath, processedCookies, userTargetId, _processedConfig$requ, requestId, targetId;
+      return _regeneratorRuntime.wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            config = _objectSpread({
+              path,
+              body
+            }, options);
+            _context.next = 1;
+            return runRequestInterceptors(_this.interceptors.request, config);
+          case 1:
+            processedConfig = _context.sent;
+            processedBody = processedConfig.body; // Universal send: dispatch by type (like response.send)
+            if (!(typeof File !== 'undefined' && processedBody instanceof File || typeof Blob !== 'undefined' && processedBody instanceof Blob)) {
+              _context.next = 2;
+              break;
+            }
+            return _context.abrupt("return", _this.sendFile(path, processedBody, options));
+          case 2:
+            if (!isIframeWritableStream(processedBody)) {
+              _context.next = 3;
+              break;
+            }
+            return _context.abrupt("return", _this.sendStream(path, processedBody, options));
+          case 3:
+            // Merge and resolve headers (initial headers + request headers)
+            mergedHeaders = _this.mergeHeaders(processedConfig, processedBody);
+            processedPath = processedConfig.path, processedCookies = processedConfig.cookies, userTargetId = processedConfig.targetId, _processedConfig$requ = processedConfig.requestId, requestId = _processedConfig$requ === void 0 ? generateRequestId() : _processedConfig$requ;
+            targetId = userTargetId || _this._targetServerId;
+            return _context.abrupt("return", _this._sendRequest(processedPath, processedBody, mergedHeaders, processedCookies, processedConfig, requestId, targetId));
+          case 4:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }))();
+  }
+
+  /**
+   * Send file as request body (stream only; server receives stream or auto-resolved File/Blob via autoResolve).
+   */
+  sendFile(path, content, options) {
+    var _this2 = this;
+    return _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+      var _options$autoResolve;
+      var streamAutoResolve, mimeType, fileName, _yield$import, IframeFileWritableStream, fileStream;
+      return _regeneratorRuntime.wrap(function (_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            streamAutoResolve = (_options$autoResolve = options === null || options === void 0 ? void 0 : options.autoResolve) !== null && _options$autoResolve !== void 0 ? _options$autoResolve : true;
+            mimeType = options === null || options === void 0 ? void 0 : options.mimeType;
+            fileName = options === null || options === void 0 ? void 0 : options.fileName;
+            _context3.next = 1;
+            return import('../stream');
+          case 1:
+            _yield$import = _context3.sent;
+            IframeFileWritableStream = _yield$import.IframeFileWritableStream;
+            fileStream = new IframeFileWritableStream({
+              filename: fileName || (typeof File !== 'undefined' && content instanceof File ? content.name : 'file'),
+              mimeType: mimeType || (typeof File !== 'undefined' && content instanceof File ? content.type : content === null || content === void 0 ? void 0 : content.type) || 'application/octet-stream',
+              chunked: false,
+              autoResolve: streamAutoResolve,
+              next: function () {
+                var _next = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
+                  var data, _t;
+                  return _regeneratorRuntime.wrap(function (_context2) {
+                    while (1) switch (_context2.prev = _context2.next) {
+                      case 0:
+                        if (!(typeof content === 'string')) {
+                          _context2.next = 1;
+                          break;
+                        }
+                        _t = btoa(unescape(encodeURIComponent(content)));
+                        _context2.next = 3;
+                        break;
+                      case 1:
+                        _context2.next = 2;
+                        return blobToBase64(content);
+                      case 2:
+                        _t = _context2.sent;
+                      case 3:
+                        data = _t;
+                        return _context2.abrupt("return", {
+                          data,
+                          done: true
+                        });
+                      case 4:
+                      case "end":
+                        return _context2.stop();
+                    }
+                  }, _callee2);
+                }));
+                function next() {
+                  return _next.apply(this, arguments);
+                }
+                return next;
+              }()
+            });
+            return _context3.abrupt("return", _this2.sendStream(path, fileStream, options));
+          case 2:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3);
+    }))();
+  }
+
+  /**
+   * Send stream as request body (server receives readable stream).
+   * Sends REQUEST with streamId and stream: true, then starts the writable stream.
+   */
+  sendStream(path, stream, options) {
+    var _this3 = this;
+    return _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
+      var _processedConfig$requ2, _processedConfig$targ;
+      var config, processedConfig, requestId, targetId, processedPath, mergedHeaders, pathMatchedCookies, mergedCookies, streamConfig, promise;
+      return _regeneratorRuntime.wrap(function (_context4) {
+        while (1) switch (_context4.prev = _context4.next) {
+          case 0:
+            config = _objectSpread({
+              path,
+              body: undefined
+            }, options);
+            _context4.next = 1;
+            return runRequestInterceptors(_this3.interceptors.request, config);
+          case 1:
+            processedConfig = _context4.sent;
+            requestId = (_processedConfig$requ2 = processedConfig.requestId) !== null && _processedConfig$requ2 !== void 0 ? _processedConfig$requ2 : generateRequestId();
+            targetId = (_processedConfig$targ = processedConfig.targetId) !== null && _processedConfig$targ !== void 0 ? _processedConfig$targ : _this3._targetServerId;
+            processedPath = processedConfig.path;
+            stream._bind({
+              requestId,
+              targetWindow: _this3.targetWindow,
+              targetOrigin: _this3.targetOrigin,
+              secretKey: _this3.secretKey,
+              channel: _this3.server.messageDispatcher.getChannel(),
+              registerStreamHandler: _this3.registerStreamHandler.bind(_this3),
+              unregisterStreamHandler: _this3.unregisterStreamHandler.bind(_this3),
+              heartbeat: () => _this3.isConnect(),
+              clientId: _this3.id,
+              targetId
+            });
+            mergedHeaders = _this3.mergeHeaders(processedConfig, undefined);
+            pathMatchedCookies = _this3._cookieStore.getForPath(processedPath);
+            mergedCookies = _objectSpread(_objectSpread({}, pathMatchedCookies), processedConfig.cookies);
+            streamConfig = _objectSpread(_objectSpread({}, processedConfig), {}, {
+              requestId
+            });
+            promise = _this3._sendRequest(processedPath, undefined, mergedHeaders, mergedCookies, streamConfig, requestId, targetId, {
+              streamId: stream.streamId
+            });
+            /** Start stream after REQUEST is sent (_sendRequest sends synchronously in executor) */
+            void stream.start();
+            return _context4.abrupt("return", promise);
+          case 2:
+          case "end":
+            return _context4.stop();
+        }
+      }, _callee4);
+    }))();
+  }
+
+  /**
+   * Internal: send REQUEST and wait for response (used by send, sendFile, sendStream).
+   */
+  _sendRequest(requestPath, body, mergedHeaders, processedCookies, processedConfig, requestId, targetId, extraPayload) {
+    var _processedConfig$ackT = processedConfig.ackTimeout,
+      ackTimeout = _processedConfig$ackT === void 0 ? this.defaultAckTimeout : _processedConfig$ackT,
+      _processedConfig$time = processedConfig.timeout,
+      timeout = _processedConfig$time === void 0 ? this.defaultTimeout : _processedConfig$time,
+      _processedConfig$asyn = processedConfig.asyncTimeout,
+      asyncTimeout = _processedConfig$asyn === void 0 ? this.defaultAsyncTimeout : _processedConfig$asyn,
+      _processedConfig$requ3 = processedConfig.requireAck,
+      requireAck = _processedConfig$requ3 === void 0 ? true : _processedConfig$requ3,
+      streamTimeout = processedConfig.streamTimeout,
+      ack = processedConfig.ack,
+      _processedConfig$retu = processedConfig.returnData,
+      returnData = _processedConfig$retu === void 0 ? this.defaultReturnData : _processedConfig$retu;
+    return new Promise((resolve, reject) => {
+      var done = false;
+      var timeoutId = null;
+      var cleanup = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        this.server._unregisterPendingRequest(requestId);
+      };
+      var fail = error => {
+        if (done) return;
+        done = true;
+        cleanup();
+        // Convert to RequestIframeError instance
+        var errorInstance = error instanceof RequestIframeError ? error : new RequestIframeError(error);
+        // Run response interceptors to allow error logging
+        Promise.reject(errorInstance).catch(err => {
+          // Run through response interceptors' rejected callbacks
+          var promise = Promise.reject(err);
+          this.interceptors.response.forEach(interceptor => {
+            promise = promise.catch(e => {
+              if (interceptor.rejected) {
+                return interceptor.rejected(e);
+              }
+              return Promise.reject(e);
+            });
+          });
+          return promise;
+        }).catch(() => {
+          // After interceptors, reject with original error
+          reject(errorInstance);
+        });
+      };
+      var setAckTimeout = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+          fail(new RequestIframeError({
+            message: formatMessage(Messages.ACK_TIMEOUT, ackTimeout),
+            code: ErrorCode.ACK_TIMEOUT,
+            config: processedConfig,
+            requestId
+          }));
+        }, ackTimeout);
+      };
+      var setRequestTimeout = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+          fail(new RequestIframeError({
+            message: formatMessage(Messages.REQUEST_TIMEOUT, timeout),
+            code: ErrorCode.TIMEOUT,
+            config: processedConfig,
+            requestId
+          }));
+        }, timeout);
+      };
+      var setAsyncTimeout = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+          fail(new RequestIframeError({
+            message: formatMessage(Messages.ASYNC_REQUEST_TIMEOUT, asyncTimeout),
+            code: ErrorCode.ASYNC_TIMEOUT,
+            config: processedConfig,
+            requestId
+          }));
+        }, asyncTimeout);
+      };
+
+      // Register to server's pending requests
+      this.server._registerPendingRequest(requestId, data => {
+        if (done) return;
+
+        // Received ACK: server has received request
+        if (data.type === MessageType.ACK) {
+          // Optional ack match (ignore mismatched ACK)
+          if (ack !== undefined && !isAckMatch(ack, data.ack)) {
+            return;
+          }
+          // Remember server's creatorId as target server ID for future requests
+          if (data.creatorId && !this._targetServerId) {
+            this._targetServerId = data.creatorId;
+          }
+          // Switch to request timeout
+          setRequestTimeout();
+          return;
+        }
+
+        // Received ASYNC notification: this is an async task
+        if (data.type === MessageType.ASYNC) {
+          // Remember server's creatorId as target server ID for future requests
+          if (data.creatorId && !this._targetServerId) {
+            this._targetServerId = data.creatorId;
+          }
+          // Switch to async timeout
+          setAsyncTimeout();
+          return;
+        }
+
+        // Received stream start message
+        if (data.type === MessageType.STREAM_START) {
+          var _streamBody$chunked, _streamBody$autoResol;
+          done = true;
+          cleanup();
+          var streamBody = data.body;
+          var streamId = streamBody.streamId;
+          var streamType = streamBody.type || StreamTypeConstant.DATA;
+          var streamMode = streamBody.mode;
+          var streamChunked = (_streamBody$chunked = streamBody.chunked) !== null && _streamBody$chunked !== void 0 ? _streamBody$chunked : true;
+          var streamMetadata = streamBody.metadata;
+          var autoResolve = (_streamBody$autoResol = streamBody.autoResolve) !== null && _streamBody$autoResol !== void 0 ? _streamBody$autoResol : false;
+
+          // Create corresponding readable stream based on stream type
+          if (streamType === StreamTypeConstant.FILE) {
+            var _readableStream = new IframeFileReadableStream(streamId, requestId, this, {
+              chunked: streamChunked,
+              metadata: streamMetadata,
+              secretKey: this.secretKey,
+              idleTimeout: streamTimeout,
+              heartbeat: () => this.isConnect(),
+              mode: streamMode,
+              filename: streamMetadata === null || streamMetadata === void 0 ? void 0 : streamMetadata.filename,
+              mimeType: streamMetadata === null || streamMetadata === void 0 ? void 0 : streamMetadata.mimeType,
+              size: streamMetadata === null || streamMetadata === void 0 ? void 0 : streamMetadata.size
+            });
+
+            // If autoResolve is enabled, automatically read and convert to File/Blob
+            if (autoResolve) {
+              var _data$headers;
+              // Extract fileName from headers if available
+              var contentDisposition = (_data$headers = data.headers) === null || _data$headers === void 0 ? void 0 : _data$headers[HttpHeader.CONTENT_DISPOSITION];
+              var fileName;
+              if (contentDisposition) {
+                var disposition = typeof contentDisposition === 'string' ? contentDisposition : contentDisposition[0];
+                var filenameMatch = disposition.match(/filename="?([^"]+)"?/i);
+                if (filenameMatch) {
+                  fileName = filenameMatch[1];
+                }
+              }
+              // Fallback to stream metadata if not found in headers
+              fileName = fileName || (streamMetadata === null || streamMetadata === void 0 ? void 0 : streamMetadata.filename) || _readableStream.filename;
+
+              // Use stream's readAsFile or readAsBlob method
+              var fileDataPromise = fileName ? _readableStream.readAsFile(fileName) : _readableStream.readAsBlob();
+              fileDataPromise.then(fileData => {
+                var resp = {
+                  data: fileData,
+                  status: data.status || HttpStatus.OK,
+                  statusText: data.statusText || HttpStatusText[HttpStatus.OK],
+                  requestId,
+                  headers: data.headers
+                };
+                return runResponseInterceptors(this.interceptors.response, resp);
+              }).then(response => {
+                resolve(returnData ? response.data : response);
+              }).catch(reject);
+              return;
+            }
+
+            // Non-autoResolve: return file stream directly
+            var _resp = {
+              data: undefined,
+              status: data.status || HttpStatus.OK,
+              statusText: data.statusText || HttpStatusText[HttpStatus.OK],
+              requestId,
+              headers: data.headers,
+              stream: _readableStream
+            };
+            runResponseInterceptors(this.interceptors.response, _resp).then(response => {
+              resolve(returnData ? response.data : response);
+            }).catch(reject);
+            return;
+          }
+
+          // Non-file stream: create regular readable stream
+          var readableStream = new IframeReadableStream(streamId, requestId, this, {
+            type: streamType,
+            mode: streamMode,
+            chunked: streamChunked,
+            metadata: streamMetadata,
+            secretKey: this.secretKey,
+            idleTimeout: streamTimeout,
+            heartbeat: () => this.isConnect()
+          });
+          var resp = {
+            data: undefined,
+            status: data.status || HttpStatus.OK,
+            statusText: data.statusText || HttpStatusText[HttpStatus.OK],
+            requestId,
+            headers: data.headers,
+            stream: readableStream
+          };
+          runResponseInterceptors(this.interceptors.response, resp).then(response => {
+            resolve(returnData ? response.data : response);
+          }).catch(reject);
+          return;
+        }
+
+        // Received stream data/end/error/cancel message - dispatch to stream handler
+        if (data.type.startsWith('stream_')) {
+          this.dispatchStreamMessage(data);
+          return;
+        }
+
+        // Received response
+        if (data.type === MessageType.RESPONSE) {
+          done = true;
+          cleanup();
+
+          // Remember server's creatorId as target server ID for future requests
+          if (data.creatorId && !this._targetServerId) {
+            this._targetServerId = data.creatorId;
+          }
+
+          // Parse and save server-set cookies (from Set-Cookie header)
+          if (data.headers && data.headers[HttpHeader.SET_COOKIE]) {
+            var setCookies = data.headers[HttpHeader.SET_COOKIE];
+            var setCookieArray = Array.isArray(setCookies) ? setCookies : [setCookies];
+            var _iterator = _createForOfIteratorHelper(setCookieArray),
+              _step;
+            try {
+              for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                var setCookieStr = _step.value;
+                this._cookieStore.setFromSetCookie(setCookieStr);
+              }
+            } catch (err) {
+              _iterator.e(err);
+            } finally {
+              _iterator.f();
+            }
+          }
+          var _resp2 = {
+            data: data.data,
+            status: data.status || HttpStatus.OK,
+            statusText: data.statusText || HttpStatusText[HttpStatus.OK],
+            requestId,
+            headers: data.headers
+          };
+          runResponseInterceptors(this.interceptors.response, _resp2).then(response => {
+            resolve(returnData ? response.data : response);
+          }).catch(reject);
+          return;
+        }
+
+        // Received error
+        if (data.type === MessageType.ERROR) {
+          var _data$error, _data$error2;
+          // Remember server's creatorId as target server ID for future requests
+          if (data.creatorId && !this._targetServerId) {
+            this._targetServerId = data.creatorId;
+          }
+          fail(new RequestIframeError({
+            message: ((_data$error = data.error) === null || _data$error === void 0 ? void 0 : _data$error.message) || Messages.REQUEST_FAILED,
+            code: ((_data$error2 = data.error) === null || _data$error2 === void 0 ? void 0 : _data$error2.code) || ErrorCode.REQUEST_ERROR,
+            config: processedConfig,
+            response: data.status ? {
+              data: data.data,
+              status: data.status,
+              statusText: data.statusText || Messages.ERROR
+            } : undefined,
+            requestId
+          }));
+        }
+      }, error => {
+        fail(new RequestIframeError({
+          message: error.message || Messages.REQUEST_FAILED,
+          code: ErrorCode.REQUEST_ERROR,
+          config: processedConfig,
+          requestId
+        }));
+      }, this.targetOrigin, this.originValidator);
+
+      // Set ACK timeout (delivery stage). If disabled, start request timeout immediately.
+      if (requireAck === false) {
+        setRequestTimeout();
+      } else {
+        setAckTimeout();
+      }
+
+      // Get cookies matching request path and merge with user-provided cookies (user-provided takes precedence)
+      var pathMatchedCookies = this._cookieStore.getForPath(requestPath);
+      var mergedCookies = _objectSpread(_objectSpread({}, pathMatchedCookies), processedCookies);
+
+      // Send request via MessageDispatcher
+      var payload = {
+        path: requestPath,
+        body,
+        headers: mergedHeaders,
+        cookies: mergedCookies,
+        targetId,
+        requireAck,
+        ack
+      };
+      if (extraPayload !== null && extraPayload !== void 0 && extraPayload.streamId) {
+        payload.streamId = extraPayload.streamId;
+      }
+
+      // Check if target window is still available before sending
+      if (!isWindowAvailable(this.targetWindow)) {
+        fail(new RequestIframeError({
+          message: Messages.TARGET_WINDOW_CLOSED,
+          code: ErrorCode.TARGET_WINDOW_CLOSED,
+          config: processedConfig,
+          requestId
+        }));
+        return;
+      }
+      this.server.messageDispatcher.sendMessage(this.targetWindow, this.targetOrigin, MessageType.REQUEST, requestId, payload);
+    });
+  }
+  /**
+   * Get internal server instance (for debugging)
+   */
+  getServer() {
+    return this.server;
+  }
+
+  /**
+   * Whether message handling is enabled
+   */
+  get isOpen() {
+    return this.server.isOpen;
+  }
+
+  /**
+   * Check if target window is still available (not closed/removed)
+   * @returns true if target window is available, false otherwise
+   */
+  isAvailable() {
+    return isWindowAvailable(this.targetWindow);
+  }
+
+  /**
+   * Enable message handling (register message handlers)
+   */
+  open() {
+    this.server.open();
+  }
+
+  /**
+   * Disable message handling (unregister message handlers, but don't release resources)
+   */
+  close() {
+    this.server.close();
+  }
+
+  /**
+   * Destroy client (close and release all resources)
+   */
+  destroy() {
+    // Clear cookies
+    this._cookieStore.clear();
+
+    // Clear stream handlers
+    this.streamHandlers.clear();
+
+    // Clear interceptors
+    this.interceptors.request.clear();
+    this.interceptors.response.clear();
+
+    // Destroy server (this will also release the message channel)
+    this.server.destroy();
+  }
+
+  /**
+   * Get all cookies matching specified path
+   * @param path Request path, returns all cookies if not provided
+   */
+  getCookies(path) {
+    if (path) {
+      return this._cookieStore.getForPath(path);
+    }
+    return this._cookieStore.getAllSimple();
+  }
+
+  /**
+   * Get specified cookie
+   * @param name Cookie name
+   * @param path Path (optional)
+   */
+  getCookie(name, path) {
+    return this._cookieStore.get(name, path);
+  }
+
+  /**
+   * Set cookie
+   * @param name Cookie name
+   * @param value Cookie value
+   * @param options Cookie options (path, etc.)
+   */
+  setCookie(name, value, options) {
+    var _options$path;
+    var expires;
+    if (options !== null && options !== void 0 && options.expires) {
+      expires = options.expires.getTime();
+    } else if ((options === null || options === void 0 ? void 0 : options.maxAge) !== undefined) {
+      expires = Date.now() + options.maxAge * 1000;
+    }
+    this._cookieStore.set({
+      name,
+      value,
+      path: (_options$path = options === null || options === void 0 ? void 0 : options.path) !== null && _options$path !== void 0 ? _options$path : '/',
+      expires
+    });
+  }
+
+  /**
+   * Remove specified cookie
+   * @param name Cookie name
+   * @param path Path (optional, defaults to '/')
+   */
+  removeCookie(name, path) {
+    this._cookieStore.remove(name, path !== null && path !== void 0 ? path : '/');
+  }
+
+  /**
+   * Clear all cookies
+   */
+  clearCookies() {
+    this._cookieStore.clear();
+  }
+}