request-iframe 0.0.1

package/library/core/client.d.ts

@@ -0,0 +1,99 @@
+import { RequestOptions, Response, RequestIframeClient, RequestDefaults } from '../types';
+import { RequestInterceptorManager, ResponseInterceptorManager } from '../interceptors';
+import { RequestIframeClientServer } from './server-client';
+import { StreamMessageHandler, StreamMessageData } from '../stream';
+/**
+ * Client configuration options
+ */
+export interface ClientOptions extends RequestDefaults {
+    secretKey?: string;
+}
+/**
+ * RequestIframeClient implementation (only responsible for initiating requests, reuses server's listener)
+ */
+export declare class RequestIframeClientImpl implements RequestIframeClient, StreamMessageHandler {
+    interceptors: {
+        request: RequestInterceptorManager;
+        response: ResponseInterceptorManager;
+    };
+    private readonly targetWindow;
+    private readonly targetOrigin;
+    private readonly server;
+    private readonly secretKey?;
+    /** Default timeout configuration */
+    private readonly defaultAckTimeout;
+    private readonly defaultTimeout;
+    private readonly defaultAsyncTimeout;
+    /**
+     * Internal cookies storage
+     * - Automatically includes cookies matching the path when sending requests
+     * - Automatically parses Set-Cookie and saves when receiving response
+     */
+    private _cookieStore;
+    /**
+     * Stream message handler map
+     * key: streamId
+     * value: stream message handler function
+     */
+    private readonly streamHandlers;
+    constructor(targetWindow: Window, targetOrigin: string, server: RequestIframeClientServer, options?: ClientOptions);
+    /**
+     * Register stream message handler (StreamMessageHandler interface implementation)
+     */
+    registerStreamHandler(streamId: string, handler: (data: StreamMessageData) => void): void;
+    /**
+     * Unregister stream message handler (StreamMessageHandler interface implementation)
+     */
+    unregisterStreamHandler(streamId: string): void;
+    /**
+     * Send message (StreamMessageHandler interface implementation)
+     */
+    postMessage(message: any): void;
+    /**
+     * Dispatch stream message to corresponding handler
+     */
+    private dispatchStreamMessage;
+    /**
+     * Check if server is reachable
+     */
+    isConnect(): Promise<boolean>;
+    send<T = any>(path: string, body?: Record<string, any>, options?: RequestOptions): Promise<Response<T>>;
+    private prefixPath;
+    /**
+     * Get internal server instance (for debugging)
+     */
+    getServer(): RequestIframeClientServer;
+    /**
+     * Get all cookies matching specified path
+     * @param path Request path, returns all cookies if not provided
+     */
+    getCookies(path?: string): Record<string, string>;
+    /**
+     * Get specified cookie
+     * @param name Cookie name
+     * @param path Path (optional)
+     */
+    getCookie(name: string, path?: string): string | undefined;
+    /**
+     * Set cookie
+     * @param name Cookie name
+     * @param value Cookie value
+     * @param options Cookie options (path, etc.)
+     */
+    setCookie(name: string, value: string, options?: {
+        path?: string;
+        expires?: Date;
+        maxAge?: number;
+    }): void;
+    /**
+     * Remove specified cookie
+     * @param name Cookie name
+     * @param path Path (optional, defaults to '/')
+     */
+    removeCookie(name: string, path?: string): void;
+    /**
+     * Clear all cookies
+     */
+    clearCookies(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,QAAQ,EAGR,mBAAmB,EACnB,eAAe,EAChB,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAG3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAY5D,OAAO,EAGL,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB,EAAE,oBAAoB;IAChF,YAAY;;;MAGjB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAkC;IAEtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;gBAGrF,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,aAAa;IAkBzB;;OAEG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;IAIhG;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAItD;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAItC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACI,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IA+CvB,IAAI,CAAC,CAAC,GAAG,GAAG,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAmQvB,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACI,SAAS,IAAI,yBAAyB;IAI7C;;;OAGG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOxD;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjE;;;;;OAKG;IACI,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,IAAI;IAgBP;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD;;OAEG;IACI,YAAY,IAAI,IAAI;CAG5B"}

package/library/core/client.js

@@ -0,0 +1,440 @@
+"use strict";
+
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.from.js");
+require("core-js/modules/es.array.slice.js");
+require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.regexp.to-string.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RequestIframeClientImpl = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.js");
+require("core-js/modules/es.promise.js");
+require("core-js/modules/es.regexp.exec.js");
+require("core-js/modules/es.string.replace.js");
+require("core-js/modules/es.string.starts-with.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _utils = require("../utils");
+var _interceptors = require("../interceptors");
+var _constants = require("../constants");
+var _stream = require("../stream");
+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; }
+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) { (0, _defineProperty2.default)(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; }
+/**
+ * Client configuration options
+ */
+
+/**
+ * RequestIframeClient implementation (only responsible for initiating requests, reuses server's listener)
+ */
+class RequestIframeClientImpl {
+  constructor(targetWindow, targetOrigin, server, options) {
+    var _options$ackTimeout, _options$timeout, _options$asyncTimeout;
+    (0, _defineProperty2.default)(this, "interceptors", {
+      request: new _interceptors.RequestInterceptorManager(),
+      response: new _interceptors.ResponseInterceptorManager()
+    });
+    /** 
+     * Internal cookies storage
+     * - Automatically includes cookies matching the path when sending requests
+     * - Automatically parses Set-Cookie and saves when receiving response
+     */
+    (0, _defineProperty2.default)(this, "_cookieStore", new _utils.CookieStore());
+    /** 
+     * Stream message handler map
+     * key: streamId
+     * value: stream message handler function
+     */
+    (0, _defineProperty2.default)(this, "streamHandlers", new Map());
+    this.targetWindow = targetWindow;
+    this.targetOrigin = targetOrigin;
+    this.server = server;
+    this.secretKey = options === null || options === void 0 ? void 0 : options.secretKey;
+
+    // Set default timeout configuration
+    this.defaultAckTimeout = (_options$ackTimeout = options === null || options === void 0 ? void 0 : options.ackTimeout) !== null && _options$ackTimeout !== void 0 ? _options$ackTimeout : _constants.DefaultTimeout.ACK;
+    this.defaultTimeout = (_options$timeout = options === null || options === void 0 ? void 0 : options.timeout) !== null && _options$timeout !== void 0 ? _options$timeout : _constants.DefaultTimeout.REQUEST;
+    this.defaultAsyncTimeout = (_options$asyncTimeout = options === null || options === void 0 ? void 0 : options.asyncTimeout) !== null && _options$asyncTimeout !== void 0 ? _options$asyncTimeout : _constants.DefaultTimeout.ASYNC;
+
+    // Register stream message processing callback
+    this.server.setStreamCallback(data => {
+      this.dispatchStreamMessage(data);
+    });
+  }
+
+  /**
+   * 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) {
+    this.server.messageDispatcher.send(this.targetWindow, message, this.targetOrigin);
+  }
+
+  /**
+   * Dispatch stream message to corresponding handler
+   */
+  dispatchStreamMessage(data) {
+    var body = data.body;
+    if (!body || !body.streamId) return;
+    var handler = this.streamHandlers.get(body.streamId);
+    if (handler) {
+      // Extract message type (remove stream_ prefix)
+      var messageType = data.type.replace('stream_', '');
+      handler(_objectSpread(_objectSpread({}, body), {}, {
+        type: messageType
+      }));
+    }
+  }
+
+  /**
+   * Check if server is reachable
+   */
+  isConnect() {
+    return new Promise(resolve => {
+      var requestId = (0, _utils.generateRequestId)();
+      var done = false;
+      var timeoutId = null;
+      var cleanup = () => {
+        if (timeoutId) clearTimeout(timeoutId);
+        this.server._unregisterPendingRequest(requestId);
+      };
+      this.server._registerPendingRequest(requestId, data => {
+        if (done) return;
+        if (data.type === _constants.MessageType.PONG) {
+          done = true;
+          cleanup();
+          resolve(true);
+        }
+      }, () => {
+        if (done) return;
+        done = true;
+        cleanup();
+        resolve(false);
+      }, this.targetOrigin);
+      timeoutId = setTimeout(() => {
+        if (done) return;
+        done = true;
+        cleanup();
+        resolve(false);
+      }, this.defaultAckTimeout);
+
+      // Send ping via MessageDispatcher
+      this.server.messageDispatcher.sendMessage(this.targetWindow, this.targetOrigin, _constants.MessageType.PING, requestId);
+    });
+  }
+  send(path, body, options) {
+    var _this = this;
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
+      var config, processedConfig, processedPath, processedBody, processedHeaders, processedCookies, _processedConfig$ackT, ackTimeout, _processedConfig$time, timeout, _processedConfig$asyn, asyncTimeout, _processedConfig$requ, requestId;
+      return _regenerator.default.wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            config = _objectSpread({
+              path,
+              body
+            }, options);
+            _context.next = 1;
+            return (0, _interceptors.runRequestInterceptors)(_this.interceptors.request, config);
+          case 1:
+            processedConfig = _context.sent;
+            processedPath = processedConfig.path, processedBody = processedConfig.body, processedHeaders = processedConfig.headers, processedCookies = processedConfig.cookies, _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$requ = processedConfig.requestId, requestId = _processedConfig$requ === void 0 ? (0, _utils.generateRequestId)() : _processedConfig$requ;
+            return _context.abrupt("return", new Promise((resolve, reject) => {
+              var prefixedPath = _this.prefixPath(processedPath);
+              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();
+                reject(error);
+              };
+              var setAckTimeout = () => {
+                if (timeoutId) clearTimeout(timeoutId);
+                timeoutId = setTimeout(() => {
+                  fail({
+                    message: (0, _constants.formatMessage)(_constants.Messages.ACK_TIMEOUT, ackTimeout),
+                    code: _constants.ErrorCode.ACK_TIMEOUT,
+                    config: processedConfig,
+                    requestId
+                  });
+                }, ackTimeout);
+              };
+              var setRequestTimeout = () => {
+                if (timeoutId) clearTimeout(timeoutId);
+                timeoutId = setTimeout(() => {
+                  fail({
+                    message: (0, _constants.formatMessage)(_constants.Messages.REQUEST_TIMEOUT, timeout),
+                    code: _constants.ErrorCode.TIMEOUT,
+                    config: processedConfig,
+                    requestId
+                  });
+                }, timeout);
+              };
+              var setAsyncTimeout = () => {
+                if (timeoutId) clearTimeout(timeoutId);
+                timeoutId = setTimeout(() => {
+                  fail({
+                    message: (0, _constants.formatMessage)(_constants.Messages.ASYNC_REQUEST_TIMEOUT, asyncTimeout),
+                    code: _constants.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 === _constants.MessageType.ACK) {
+                  // Switch to request timeout
+                  setRequestTimeout();
+                  return;
+                }
+
+                // Received ASYNC notification: this is an async task
+                if (data.type === _constants.MessageType.ASYNC) {
+                  // Switch to async timeout
+                  setAsyncTimeout();
+                  return;
+                }
+
+                // Received stream start message
+                if (data.type === _constants.MessageType.STREAM_START) {
+                  var _streamBody$chunked;
+                  done = true;
+                  cleanup();
+                  var streamBody = data.body;
+                  var streamId = streamBody.streamId;
+                  var streamType = streamBody.type || _constants.StreamType.DATA;
+                  var streamChunked = (_streamBody$chunked = streamBody.chunked) !== null && _streamBody$chunked !== void 0 ? _streamBody$chunked : true;
+                  var streamMetadata = streamBody.metadata;
+
+                  // Create corresponding readable stream based on stream type
+                  var readableStream;
+                  if (streamType === _constants.StreamType.FILE) {
+                    readableStream = new _stream.IframeFileReadableStream(streamId, requestId, _this, {
+                      chunked: streamChunked,
+                      metadata: streamMetadata,
+                      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
+                    });
+                  } else {
+                    readableStream = new _stream.IframeReadableStream(streamId, requestId, _this, {
+                      type: streamType,
+                      chunked: streamChunked,
+                      metadata: streamMetadata
+                    });
+                  }
+                  var resp = {
+                    data: undefined,
+                    status: data.status || _constants.HttpStatus.OK,
+                    statusText: data.statusText || _constants.HttpStatusText[_constants.HttpStatus.OK],
+                    requestId,
+                    headers: data.headers,
+                    stream: readableStream
+                  };
+                  (0, _interceptors.runResponseInterceptors)(_this.interceptors.response, resp).then(resolve).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 === _constants.MessageType.RESPONSE) {
+                  done = true;
+                  cleanup();
+
+                  // If server requires acknowledgment, send received message
+                  if (data.requireAck) {
+                    _this.server.messageDispatcher.sendMessage(_this.targetWindow, _this.targetOrigin, _constants.MessageType.RECEIVED, requestId, {
+                      path: prefixedPath
+                    });
+                  }
+
+                  // Parse and save server-set cookies (from Set-Cookie header)
+                  if (data.headers && data.headers[_constants.HttpHeader.SET_COOKIE]) {
+                    var setCookies = data.headers[_constants.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 _resp = {
+                    data: data.data,
+                    status: data.status || _constants.HttpStatus.OK,
+                    statusText: data.statusText || _constants.HttpStatusText[_constants.HttpStatus.OK],
+                    requestId,
+                    headers: data.headers,
+                    fileData: data.fileData
+                  };
+                  (0, _interceptors.runResponseInterceptors)(_this.interceptors.response, _resp).then(resolve).catch(reject);
+                  return;
+                }
+
+                // Received error
+                if (data.type === _constants.MessageType.ERROR) {
+                  var _data$error, _data$error2;
+                  // If server requires acknowledgment, send received message
+                  if (data.requireAck) {
+                    _this.server.messageDispatcher.sendMessage(_this.targetWindow, _this.targetOrigin, _constants.MessageType.RECEIVED, requestId, {
+                      path: prefixedPath
+                    });
+                  }
+                  var err = {
+                    message: ((_data$error = data.error) === null || _data$error === void 0 ? void 0 : _data$error.message) || _constants.Messages.REQUEST_FAILED,
+                    code: ((_data$error2 = data.error) === null || _data$error2 === void 0 ? void 0 : _data$error2.code) || _constants.ErrorCode.REQUEST_ERROR,
+                    config: processedConfig,
+                    response: data.status ? {
+                      data: data.data,
+                      status: data.status,
+                      statusText: data.statusText || _constants.Messages.ERROR
+                    } : undefined,
+                    requestId
+                  };
+                  fail(err);
+                }
+              }, error => {
+                fail({
+                  message: error.message || _constants.Messages.REQUEST_FAILED,
+                  code: _constants.ErrorCode.REQUEST_ERROR,
+                  config: processedConfig,
+                  requestId
+                });
+              }, _this.targetOrigin);
+
+              // Set ACK timeout
+              setAckTimeout();
+
+              // Get cookies matching request path and merge with user-provided cookies (user-provided takes precedence)
+              var pathMatchedCookies = _this._cookieStore.getForPath(processedPath);
+              var mergedCookies = _objectSpread(_objectSpread({}, pathMatchedCookies), processedCookies);
+
+              // Send request via MessageDispatcher
+              _this.server.messageDispatcher.sendMessage(_this.targetWindow, _this.targetOrigin, _constants.MessageType.REQUEST, requestId, {
+                path: prefixedPath,
+                body: processedBody,
+                headers: processedHeaders,
+                cookies: mergedCookies
+              });
+            }));
+          case 2:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }))();
+  }
+  prefixPath(path) {
+    return this.secretKey ? `${this.secretKey}:${path}` : path;
+  }
+
+  /**
+   * Get internal server instance (for debugging)
+   */
+  getServer() {
+    return this.server;
+  }
+
+  /**
+   * 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();
+  }
+}
+exports.RequestIframeClientImpl = RequestIframeClientImpl;

package/library/core/message-handler.d.ts

@@ -0,0 +1,110 @@
+import { PostMessageData, ServerEventName } from '../types';
+/**
+ * 消息处理器配置
+ */
+export interface MessageHandlerOptions {
+    /** 消息隔离标识 */
+    uniqueKey?: string;
+    /** ACK 超时时间 */
+    ackTimeout?: number;
+}
+/**
+ * 消息处理回调
+ */
+export interface MessageHandlerCallbacks {
+    /** 处理请求 */
+    onRequest?: (data: PostMessageData, event: MessageEvent) => void;
+    /** 处理客户端响应（ack、async、response、error） */
+    onClientResponse?: (data: PostMessageData, event: MessageEvent) => void;
+    /** 处理 received 确认 */
+    onReceived?: (data: PostMessageData, event: MessageEvent) => void;
+    /** 处理 ping */
+    onPing?: (data: PostMessageData, event: MessageEvent) => void;
+    /** 处理 pong */
+    onPong?: (data: PostMessageData, event: MessageEvent) => void;
+    /** 处理流消息 */
+    onStream?: (data: PostMessageData, event: MessageEvent) => void;
+}
+/**
+ * IframeMessageHandler - 底层消息处理器
+ * 负责 postMessage 监听、协议验证、uniqueKey 隔离、事件分发
+ */
+export declare class IframeMessageHandler {
+    readonly uniqueKey?: string;
+    readonly ackTimeout: number;
+    private readonly listeners;
+    /** 等待客户端确认的响应 */
+    private readonly pendingAcks;
+    /** 等待响应的请求 */
+    private readonly pendingRequests;
+    /** 消息处理回调 */
+    private callbacks;
+    /** 消息监听函数（绑定 this） */
+    private readonly boundOnMessage;
+    constructor(options?: MessageHandlerOptions);
+    /**
+     * 设置消息处理回调
+     */
+    setCallbacks(callbacks: MessageHandlerCallbacks): void;
+    /**
+     * 消息处理入口
+     */
+    private onMessage;
+    /**
+     * 分发消息到具体处理器
+     */
+    private dispatchMessage;
+    /**
+     * 处理客户端响应
+     */
+    private handleClientResponse;
+    /**
+     * 处理 received 确认
+     */
+    private handleReceived;
+    /**
+     * 处理 ping
+     */
+    private handlePing;
+    /**
+     * 处理 pong
+     */
+    private handlePong;
+    /**
+     * 注册等待确认的响应
+     */
+    registerPendingAck(requestId: string, resolve: (received: boolean) => void, reject: (error: Error) => void): void;
+    /**
+     * 注册等待响应的请求
+     */
+    registerPendingRequest(requestId: string, resolve: (data: PostMessageData) => void, reject: (error: Error) => void, origin?: string): void;
+    /**
+     * 取消等待响应
+     */
+    unregisterPendingRequest(requestId: string): void;
+    /**
+     * 监听事件
+     */
+    on(event: ServerEventName, fn: (payload: any, messageEvent?: MessageEvent) => void): void;
+    /**
+     * 取消监听
+     */
+    off(event: ServerEventName, fn?: (payload: any, messageEvent?: MessageEvent) => void): void;
+    /**
+     * 触发事件
+     */
+    private emit;
+    /**
+     * 添加 path 前缀
+     */
+    prefixPath(path: string): string;
+    /**
+     * 发送协议版本错误
+     */
+    private sendProtocolError;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=message-handler.d.ts.map

package/library/core/message-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../../src/core/message-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW;IACX,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjE,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxE,qBAAqB;IACrB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAClE,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9D,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9D,YAAY;IACZ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACjE;AAyBD;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CASxB;IAEF,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,cAAc;IACd,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,aAAa;IACb,OAAO,CAAC,SAAS,CAA+B;IAEhD,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;gBAE5C,OAAO,CAAC,EAAE,qBAAqB;IAOlD;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAI7D;;OAEG;IACH,OAAO,CAAC,SAAS;IA6BjB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACI,kBAAkB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,EACpC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC7B,IAAI;IASP;;OAEG;IACI,sBAAsB,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,EACxC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;IAIP;;OAEG;IACI,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxD;;OAEG;IACI,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAIhG;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQlG;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACI,OAAO,IAAI,IAAI;CASvB"}