request-iframe 0.0.1

package/library/core/response.js

@@ -0,0 +1,323 @@
+"use strict";
+
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.object.get-own-property-descriptors.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.ServerResponseImpl = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+require("core-js/modules/es.array.includes.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.promise.js");
+require("core-js/modules/es.string.includes.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 _constants = require("../constants");
+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; }
+/**
+ * Callback waiting for client acknowledgment
+ */
+
+/**
+ * ServerResponse implementation
+ */
+class ServerResponseImpl {
+  constructor(requestId, path, secretKey, targetWindow, targetOrigin, channel) {
+    (0, _defineProperty2.default)(this, "statusCode", _constants.HttpStatus.OK);
+    (0, _defineProperty2.default)(this, "headers", {});
+    (0, _defineProperty2.default)(this, "_sent", false);
+    this.requestId = requestId;
+    this.path = path;
+    this.secretKey = secretKey;
+    this.targetWindow = targetWindow;
+    this.targetOrigin = targetOrigin;
+    this.channel = channel;
+  }
+
+  /**
+   * Send message via channel or direct postMessage
+   */
+  sendMessage(message) {
+    if (this.channel) {
+      this.channel.send(this.targetWindow, message, this.targetOrigin);
+    } else {
+      this.targetWindow.postMessage(message, this.targetOrigin);
+    }
+  }
+
+  /**
+   * Set callback waiting for client acknowledgment
+   */
+  _setOnAckCallback(callback) {
+    this.onAckCallback = callback;
+  }
+
+  /**
+   * Trigger client acknowledgment callback
+   */
+  _triggerAck(received) {
+    if (this.onAckCallback) {
+      this.onAckCallback(received);
+      this.onAckCallback = undefined;
+    }
+  }
+  send(data, options) {
+    var _options$requireAck;
+    if (this._sent) return Promise.resolve(false);
+    this._sent = true;
+    var requireAck = (_options$requireAck = options === null || options === void 0 ? void 0 : options.requireAck) !== null && _options$requireAck !== void 0 ? _options$requireAck : false;
+
+    // If acknowledgment not required, send directly and return true
+    if (!requireAck) {
+      this.sendMessage((0, _utils.createPostMessage)(_constants.MessageType.RESPONSE, this.requestId, {
+        path: this.path,
+        secretKey: this.secretKey,
+        data,
+        status: this.statusCode,
+        statusText: (0, _constants.getStatusText)(this.statusCode),
+        headers: this.headers,
+        requireAck: false
+      }));
+      return Promise.resolve(true);
+    }
+
+    // Acknowledgment required, wait for client response
+    return new Promise(resolve => {
+      this._setOnAckCallback(resolve);
+      this.sendMessage((0, _utils.createPostMessage)(_constants.MessageType.RESPONSE, this.requestId, {
+        path: this.path,
+        secretKey: this.secretKey,
+        data,
+        status: this.statusCode,
+        statusText: (0, _constants.getStatusText)(this.statusCode),
+        headers: this.headers,
+        requireAck: true
+      }));
+    });
+  }
+  json(data, options) {
+    this.setHeader(_constants.HttpHeader.CONTENT_TYPE, 'application/json');
+    return this.send(data, options);
+  }
+  sendFile(content, options) {
+    var _this = this;
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
+      var _options$requireAck2;
+      var requireAck, base64Content, mimeType, fileName, fileHeaders, messageData;
+      return _regenerator.default.wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            if (!_this._sent) {
+              _context.next = 1;
+              break;
+            }
+            return _context.abrupt("return", false);
+          case 1:
+            _this._sent = true;
+            requireAck = (_options$requireAck2 = options === null || options === void 0 ? void 0 : options.requireAck) !== null && _options$requireAck2 !== void 0 ? _options$requireAck2 : false;
+            mimeType = (options === null || options === void 0 ? void 0 : options.mimeType) || 'application/octet-stream';
+            fileName = options === null || options === void 0 ? void 0 : options.fileName;
+            if (!(typeof content === 'string')) {
+              _context.next = 2;
+              break;
+            }
+            // If it's a plain string, convert to base64
+            base64Content = btoa(unescape(encodeURIComponent(content)));
+            _context.next = 6;
+            break;
+          case 2:
+            if (!(content instanceof File)) {
+              _context.next = 4;
+              break;
+            }
+            mimeType = content.type || mimeType;
+            fileName = fileName || content.name;
+            _context.next = 3;
+            return _this.blobToBase64(content);
+          case 3:
+            base64Content = _context.sent;
+            _context.next = 6;
+            break;
+          case 4:
+            _context.next = 5;
+            return _this.blobToBase64(content);
+          case 5:
+            base64Content = _context.sent;
+          case 6:
+            // Merge file-related headers
+            fileHeaders = _objectSpread(_objectSpread({}, _this.headers), {}, {
+              [_constants.HttpHeader.CONTENT_TYPE]: mimeType,
+              [_constants.HttpHeader.CONTENT_DISPOSITION]: fileName ? `attachment; filename="${fileName}"` : 'attachment'
+            });
+            messageData = (0, _utils.createPostMessage)(_constants.MessageType.RESPONSE, _this.requestId, {
+              path: _this.path,
+              secretKey: _this.secretKey,
+              status: _this.statusCode,
+              statusText: (0, _constants.getStatusText)(_this.statusCode),
+              headers: fileHeaders,
+              fileData: {
+                content: base64Content,
+                mimeType,
+                fileName
+              },
+              requireAck
+            }); // If acknowledgment not required, send directly and return true
+            if (requireAck) {
+              _context.next = 7;
+              break;
+            }
+            _this.sendMessage(messageData);
+            return _context.abrupt("return", true);
+          case 7:
+            return _context.abrupt("return", new Promise(resolve => {
+              _this._setOnAckCallback(resolve);
+              _this.sendMessage(messageData);
+            }));
+          case 8:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }))();
+  }
+
+  /**
+   * Send stream response
+   * Bind stream to current request context and start stream transmission
+   */
+  sendStream(stream) {
+    var _this2 = this;
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
+      return _regenerator.default.wrap(function (_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            if (!_this2._sent) {
+              _context2.next = 1;
+              break;
+            }
+            return _context2.abrupt("return");
+          case 1:
+            _this2._sent = true;
+
+            // Bind stream to request context
+            stream._bind({
+              requestId: _this2.requestId,
+              targetWindow: _this2.targetWindow,
+              targetOrigin: _this2.targetOrigin,
+              secretKey: _this2.secretKey,
+              channel: _this2.channel
+            });
+
+            // Start stream transmission
+            _context2.next = 2;
+            return stream.start();
+          case 2:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2);
+    }))();
+  }
+  status(code) {
+    this.statusCode = code;
+    return this;
+  }
+  setHeader(name, value) {
+    // Consistent with Express, returns void
+    // Special handling for Set-Cookie, keep as array
+    if (name.toLowerCase() === _constants.HttpHeader.SET_COOKIE.toLowerCase()) {
+      var existing = this.headers[_constants.HttpHeader.SET_COOKIE];
+      if (Array.isArray(value)) {
+        this.headers[_constants.HttpHeader.SET_COOKIE] = Array.isArray(existing) ? [...existing, ...value] : value;
+      } else {
+        var newValue = String(value);
+        if (Array.isArray(existing)) {
+          existing.push(newValue);
+        } else {
+          this.headers[_constants.HttpHeader.SET_COOKIE] = [newValue];
+        }
+      }
+    } else if (Array.isArray(value)) {
+      this.headers[name] = value.join(', ');
+    } else {
+      this.headers[name] = String(value);
+    }
+  }
+  set(name, value) {
+    // Chainable version, compatible with Express res.set
+    this.setHeader(name, value);
+    return this;
+  }
+  cookie(name, value, options) {
+    /**
+     * Set Cookie (similar to HTTP Set-Cookie)
+     * Generate Set-Cookie string and add to headers[HttpHeader.SET_COOKIE] array
+     * Client will parse and save to cookie storage upon receiving
+     */
+    var setCookieStr = (0, _utils.createSetCookie)(name, value, {
+      path: options === null || options === void 0 ? void 0 : options.path,
+      expires: options === null || options === void 0 ? void 0 : options.expires,
+      maxAge: options === null || options === void 0 ? void 0 : options.maxAge,
+      httpOnly: options === null || options === void 0 ? void 0 : options.httpOnly,
+      secure: options === null || options === void 0 ? void 0 : options.secure,
+      sameSite: (options === null || options === void 0 ? void 0 : options.sameSite) === true ? 'Strict' : (options === null || options === void 0 ? void 0 : options.sameSite) === false ? undefined : options === null || options === void 0 ? void 0 : options.sameSite
+    });
+
+    // Add to Set-Cookie header array
+    var existing = this.headers[_constants.HttpHeader.SET_COOKIE];
+    if (Array.isArray(existing)) {
+      existing.push(setCookieStr);
+    } else {
+      this.headers[_constants.HttpHeader.SET_COOKIE] = [setCookieStr];
+    }
+    return this;
+  }
+  clearCookie(name, options) {
+    /**
+     * Clear specified Cookie
+     * Generate an expired Set-Cookie string, client will delete this cookie upon receiving
+     */
+    var setCookieStr = (0, _utils.createClearCookie)(name, {
+      path: options === null || options === void 0 ? void 0 : options.path
+    });
+
+    // Add to Set-Cookie header array
+    var existing = this.headers[_constants.HttpHeader.SET_COOKIE];
+    if (Array.isArray(existing)) {
+      existing.push(setCookieStr);
+    } else {
+      this.headers[_constants.HttpHeader.SET_COOKIE] = [setCookieStr];
+    }
+    return this;
+  }
+  blobToBase64(blob) {
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3() {
+      return _regenerator.default.wrap(function (_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            return _context3.abrupt("return", new Promise((resolve, reject) => {
+              var reader = new FileReader();
+              reader.onloadend = () => {
+                var result = reader.result;
+                // Remove data URL prefix (e.g., "data:image/png;base64,")
+                var base64 = result.includes(',') ? result.split(',')[1] : result;
+                resolve(base64);
+              };
+              reader.onerror = reject;
+              reader.readAsDataURL(blob);
+            }));
+          case 1:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3);
+    }))();
+  }
+}
+exports.ServerResponseImpl = ServerResponseImpl;

package/library/core/server-base.d.ts

@@ -0,0 +1,86 @@
+import { PostMessageData, ServerEventName } from '../types';
+/**
+ * server 内部事件监听器集合
+ */
+type ServerListeners = Record<ServerEventName, Set<(payload: any, event?: MessageEvent) => void>>;
+/**
+ * 等待客户端确认的响应
+ */
+interface PendingAck {
+    resolve: (received: boolean) => void;
+    reject: (error: Error) => void;
+    timeoutId: ReturnType<typeof setTimeout>;
+}
+/**
+ * RequestIframeBaseServer 基类（封装基本的请求交互逻辑）
+ */
+export declare abstract class RequestIframeBaseServer {
+    protected readonly uniqueKey?: string;
+    protected readonly ackTimeout: number;
+    protected readonly listeners: ServerListeners;
+    /** 等待客户端确认的响应 */
+    protected readonly pendingAcks: Map<string, PendingAck>;
+    /** 客户端等待响应的请求 */
+    protected readonly pendingClientRequests: Map<string, {
+        resolve: (data: PostMessageData) => void;
+        reject: (error: Error) => void;
+        origin?: string;
+    }>;
+    protected readonly onMessage: (event: MessageEvent) => void;
+    constructor(options?: {
+        uniqueKey?: string;
+        ackTimeout?: number;
+    });
+    /**
+     * 处理请求（由子类实现）
+     */
+    protected abstract handleRequest(data: PostMessageData, event: MessageEvent): void;
+    /**
+     * 处理客户端响应（ack、async、response、error）
+     */
+    protected handleClientResponse(data: PostMessageData, event: MessageEvent): void;
+    /**
+     * 处理客户端确认收到
+     */
+    protected handleReceived(data: PostMessageData): void;
+    /**
+     * 处理 ping 请求（用于 isConnect）
+     */
+    protected handlePing(data: PostMessageData, event: MessageEvent): void;
+    /**
+     * 处理 pong 响应（用于 isConnect）
+     */
+    protected handlePong(data: PostMessageData, event: MessageEvent): void;
+    /**
+     * 注册等待客户端确认的响应
+     */
+    _registerPendingAck(requestId: string, resolve: (received: boolean) => void, reject: (error: Error) => void): void;
+    /**
+     * 内部方法：监听底层事件
+     */
+    _on(event: ServerEventName, fn: (payload: any, messageEvent?: MessageEvent) => void): void;
+    /**
+     * 内部方法：取消监听底层事件
+     */
+    _off(event: ServerEventName, fn?: (payload: any, messageEvent?: MessageEvent) => void): void;
+    /**
+     * 内部方法：供 client 注册等待响应的 Promise
+     */
+    _registerPendingRequest(requestId: string, resolve: (data: PostMessageData) => void, reject: (error: Error) => void, origin?: string): void;
+    /**
+     * 内部方法：供 client 取消等待
+     */
+    _unregisterPendingRequest(requestId: string): void;
+    /**
+     * 销毁 server（移除 message 监听）
+     */
+    destroy(): void;
+    protected emit(event: ServerEventName, payload: any, messageEvent?: MessageEvent): void;
+    protected prefixPath(path: string): string;
+    /**
+     * 发送协议版本不兼容错误（版本过低）
+     */
+    protected sendProtocolError(data: PostMessageData, event: MessageEvent, remoteVersion: number): void;
+}
+export {};
+//# sourceMappingURL=server-base.d.ts.map

package/library/core/server-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-base.d.ts","sourceRoot":"","sources":["../../src/core/server-base.ts"],"names":[],"mappings":"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"}

package/library/core/server-base.js

@@ -0,0 +1,257 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RequestIframeBaseServer = void 0;
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.js");
+require("core-js/modules/es.set.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _utils = require("../utils");
+var _constants = require("../constants");
+/**
+ * server 内部事件监听器集合
+ */
+
+/**
+ * 等待客户端确认的响应
+ */
+
+/**
+ * RequestIframeBaseServer 基类（封装基本的请求交互逻辑）
+ */
+class RequestIframeBaseServer {
+  constructor(options) {
+    var _options$ackTimeout;
+    (0, _defineProperty2.default)(this, "listeners", {
+      request: new Set(),
+      ack: new Set(),
+      async: new Set(),
+      response: new Set(),
+      error: new Set(),
+      received: new Set(),
+      ping: new Set(),
+      pong: new Set()
+    });
+    /** 等待客户端确认的响应 */
+    (0, _defineProperty2.default)(this, "pendingAcks", new Map());
+    /** 客户端等待响应的请求 */
+    (0, _defineProperty2.default)(this, "pendingClientRequests", new Map());
+    (0, _defineProperty2.default)(this, "onMessage", event => {
+      var data = event.data;
+
+      // 检查是否是 request-iframe 框架的消息（基本格式验证）
+      if (!(0, _utils.isValidPostMessage)(data)) {
+        return;
+      }
+
+      // 检查协议版本兼容性
+      var version = (0, _utils.getProtocolVersion)(data);
+      if (version !== undefined && !(0, _utils.isCompatibleVersion)(version)) {
+        // 协议版本不兼容，通知对方
+        this.sendProtocolError(data, event, version);
+        return;
+      }
+
+      // uniqueKey 隔离：不匹配则忽略
+      if (this.uniqueKey) {
+        if (data.uniqueKey !== this.uniqueKey) return;
+      } else {
+        if (data.uniqueKey) return;
+      }
+
+      // 触发框架内部事件监听器
+      this.emit(data.type, data, event);
+
+      // 处理请求（由子类实现）
+      if (data.type === _constants.MessageType.REQUEST) {
+        this.handleRequest(data, event);
+        return;
+      }
+
+      // 处理响应和错误（供 client 使用）
+      if (data.type === _constants.MessageType.RESPONSE || data.type === _constants.MessageType.ERROR || data.type === _constants.MessageType.ACK || data.type === _constants.MessageType.ASYNC) {
+        this.handleClientResponse(data, event);
+        return;
+      }
+
+      // 处理客户端确认收到（received）
+      if (data.type === _constants.MessageType.RECEIVED) {
+        this.handleReceived(data);
+        return;
+      }
+
+      // 处理 ping（用于 isConnect）
+      if (data.type === _constants.MessageType.PING) {
+        this.handlePing(data, event);
+        return;
+      }
+
+      // 处理 pong（用于 isConnect）
+      if (data.type === _constants.MessageType.PONG) {
+        this.handlePong(data, event);
+        return;
+      }
+    });
+    this.uniqueKey = options === null || options === void 0 ? void 0 : options.uniqueKey;
+    this.ackTimeout = (_options$ackTimeout = options === null || options === void 0 ? void 0 : options.ackTimeout) !== null && _options$ackTimeout !== void 0 ? _options$ackTimeout : _constants.DefaultTimeout.SERVER_ACK;
+    window.addEventListener('message', this.onMessage);
+  }
+
+  /**
+   * 处理请求（由子类实现）
+   */
+
+  /**
+   * 处理客户端响应（ack、async、response、error）
+   */
+  handleClientResponse(data, event) {
+    var pending = this.pendingClientRequests.get(data.requestId);
+    if (pending) {
+      // 验证 origin（如果指定了）
+      if (pending.origin && pending.origin !== '*' && event.origin !== pending.origin) {
+        return;
+      }
+      // 对于 ack 和 async，不删除 pending，只触发回调
+      if (data.type === _constants.MessageType.ACK || data.type === _constants.MessageType.ASYNC) {
+        pending.resolve(data);
+        return;
+      }
+      // 对于 response 和 error，删除 pending 并触发回调
+      this.pendingClientRequests.delete(data.requestId);
+      pending.resolve(data);
+    }
+  }
+
+  /**
+   * 处理客户端确认收到
+   */
+  handleReceived(data) {
+    var pending = this.pendingAcks.get(data.requestId);
+    if (pending) {
+      clearTimeout(pending.timeoutId);
+      this.pendingAcks.delete(data.requestId);
+      pending.resolve(true);
+    }
+  }
+
+  /**
+   * 处理 ping 请求（用于 isConnect）
+   */
+  handlePing(data, event) {
+    if (!event.source) return;
+    event.source.postMessage((0, _utils.createPostMessage)(_constants.MessageType.PONG, data.requestId, {
+      uniqueKey: data.uniqueKey
+    }), event.origin);
+  }
+
+  /**
+   * 处理 pong 响应（用于 isConnect）
+   */
+  handlePong(data, event) {
+    var pending = this.pendingClientRequests.get(data.requestId);
+    if (pending) {
+      if (pending.origin && pending.origin !== '*' && event.origin !== pending.origin) {
+        return;
+      }
+      this.pendingClientRequests.delete(data.requestId);
+      pending.resolve(data);
+    }
+  }
+
+  /**
+   * 注册等待客户端确认的响应
+   */
+  _registerPendingAck(requestId, resolve, reject) {
+    var timeoutId = setTimeout(() => {
+      this.pendingAcks.delete(requestId);
+      resolve(false); // 超时未收到确认，但不报错
+    }, this.ackTimeout);
+    this.pendingAcks.set(requestId, {
+      resolve,
+      reject,
+      timeoutId
+    });
+  }
+
+  /**
+   * 内部方法：监听底层事件
+   */
+  _on(event, fn) {
+    this.listeners[event].add(fn);
+  }
+
+  /**
+   * 内部方法：取消监听底层事件
+   */
+  _off(event, fn) {
+    if (!fn) {
+      this.listeners[event].clear();
+      return;
+    }
+    this.listeners[event].delete(fn);
+  }
+
+  /**
+   * 内部方法：供 client 注册等待响应的 Promise
+   */
+  _registerPendingRequest(requestId, resolve, reject, origin) {
+    this.pendingClientRequests.set(requestId, {
+      resolve,
+      reject,
+      origin
+    });
+  }
+
+  /**
+   * 内部方法：供 client 取消等待
+   */
+  _unregisterPendingRequest(requestId) {
+    this.pendingClientRequests.delete(requestId);
+  }
+
+  /**
+   * 销毁 server（移除 message 监听）
+   */
+  destroy() {
+    window.removeEventListener('message', this.onMessage);
+    this.pendingClientRequests.clear();
+    this.pendingAcks.forEach(pending => clearTimeout(pending.timeoutId));
+    this.pendingAcks.clear();
+    Object.keys(this.listeners).forEach(k => this.listeners[k].clear());
+  }
+  emit(event, payload, messageEvent) {
+    this.listeners[event].forEach(fn => {
+      try {
+        fn(payload, messageEvent);
+      } catch (e) {
+        // 忽略监听器异常
+      }
+    });
+  }
+  prefixPath(path) {
+    return this.uniqueKey ? `${this.uniqueKey}:${path}` : path;
+  }
+
+  /**
+   * 发送协议版本不兼容错误（版本过低）
+   */
+  sendProtocolError(data, event, remoteVersion) {
+    if (!event.source) return;
+    event.source.postMessage((0, _utils.createPostMessage)(_constants.MessageType.ERROR, data.requestId, {
+      path: data.path,
+      uniqueKey: data.uniqueKey,
+      status: _constants.HttpStatus.BAD_REQUEST,
+      statusText: _constants.Messages.PROTOCOL_VERSION_UNSUPPORTED,
+      error: {
+        message: (0, _constants.formatMessage)(_constants.Messages.PROTOCOL_VERSION_TOO_LOW, remoteVersion, _constants.ProtocolVersion.MIN_SUPPORTED),
+        code: _constants.ErrorCode.PROTOCOL_UNSUPPORTED
+      }
+    }), event.origin);
+  }
+}
+exports.RequestIframeBaseServer = RequestIframeBaseServer;