request-iframe 0.1.0 → 0.2.0

package/library/{core → impl}/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,cAAc,EAAE,eAAe,EAC/C,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC9C,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,cAAc,CAAC;gBAGzB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAkBtC"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/impl/request.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,cAAc,EAAE,eAAe,EAC/C,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC9C,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,cAAc,CAAC;gBAGzB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAkBtC"}

package/library/{core → impl}/response.d.ts

@@ -1,10 +1,10 @@
 import { ServerResponse, CookieOptions, SendOptions, SendFileOptions } from '../types';
 import { IframeWritableStream } from '../stream';
-import { MessageChannel } from '../message';
+import { RequestIframeEndpointOutbox } from '../endpoint';
 /**
  * Callback waiting for client acknowledgment
  */
-type AckCallback = (received: boolean, ackMeta?: any) => void;
+type AckCallback = (received: boolean, ack?: any) => void;
 type OnSentCallback = () => void;
 /**
  * ServerResponse implementation
@@ -14,30 +14,25 @@ export declare class ServerResponseImpl implements ServerResponse {
     headers: Record<string, string | string[]>;
     private readonly requestId;
     private readonly path;
-    private readonly secretKey?;
-    private readonly targetWindow;
-    private readonly targetOrigin;
-    private readonly channel;
+    private readonly peer;
     private readonly registerStreamHandler?;
     private readonly unregisterStreamHandler?;
     private readonly heartbeat?;
-    /** Target client ID (usually the creatorId of the original request) */
-    private readonly targetId?;
     /** Server instance ID (for creatorId in responses) */
     private readonly serverId?;
     private onAckCallback?;
     private onSentCallback?;
     _sent: boolean;
-    constructor(requestId: string, path: string, secretKey: string | undefined, targetWindow: Window, targetOrigin: string, channel: MessageChannel, serverId?: string, targetId?: string, options?: {
+    constructor(requestId: string, path: string, serverId?: string, peer?: RequestIframeEndpointOutbox, options?: {
         registerStreamHandler?: (streamId: string, handler: (data: any) => void) => void;
         unregisterStreamHandler?: (streamId: string) => void;
         heartbeat?: () => Promise<boolean>;
         onSent?: OnSentCallback;
     });
     /**
-     * Send message via channel
+     * Send message via bound peer
      */
-    private sendMessage;
+    private sendResponseMessage;
     /**
      * Check if header exists (case-insensitive)
      */
@@ -58,7 +53,7 @@ export declare class ServerResponseImpl implements ServerResponse {
     /**
      * Trigger client acknowledgment callback
      */
-    _triggerAck(received: boolean, ackMeta?: any): void;
+    _triggerAck(received: boolean, ack?: any): void;
     /**
      * Mark response as sent (and trigger onSent callback once).
      */

package/library/impl/response.d.ts.map

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

package/library/{core → impl}/response.js

@@ -14,10 +14,11 @@ require("core-js/modules/es.promise.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 _cookie = require("../utils/cookie");
+var _contentType = require("../utils/content-type");
 var _constants = require("../constants");
 var _stream = require("../stream");
-var _ackMeta = require("../utils/ack-meta");
+var _endpoint = require("../endpoint");
 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; }
 /**
@@ -28,18 +29,14 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
  * ServerResponse implementation
  */
 class ServerResponseImpl {
-  constructor(requestId, path, secretKey, targetWindow, targetOrigin, channel, serverId, targetId, options) {
+  constructor(requestId, path, serverId, peer, options) {
     (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;
     this.serverId = serverId;
-    this.targetId = targetId;
+    this.peer = peer;
     this.registerStreamHandler = options === null || options === void 0 ? void 0 : options.registerStreamHandler;
     this.unregisterStreamHandler = options === null || options === void 0 ? void 0 : options.unregisterStreamHandler;
     this.heartbeat = options === null || options === void 0 ? void 0 : options.heartbeat;
@@ -47,11 +44,10 @@ class ServerResponseImpl {
   }
 
   /**
-   * Send message via channel
+   * Send message via bound peer
    */
-  sendMessage(message) {
-    // Window check is handled in MessageDispatcher (via channel.send -> dispatcher.send)
-    this.channel.send(this.targetWindow, message, this.targetOrigin);
+  sendResponseMessage(data) {
+    return this.peer.sendMessage(_constants.MessageType.RESPONSE, this.requestId, data);
   }
 
   /**
@@ -67,7 +63,7 @@ class ServerResponseImpl {
    * Returns null if Content-Type should not be auto-set
    */
   detectContentType(data) {
-    return (0, _utils.detectContentType)(data, {
+    return (0, _contentType.detectContentType)(data, {
       checkStream: true,
       isIframeWritableStream: _stream.isIframeWritableStream
     });
@@ -94,9 +90,9 @@ class ServerResponseImpl {
   /**
    * Trigger client acknowledgment callback
    */
-  _triggerAck(received, ackMeta) {
+  _triggerAck(received, ack) {
     if (this.onAckCallback) {
-      this.onAckCallback(received, ackMeta);
+      this.onAckCallback(received, ack);
       this.onAckCallback = undefined;
     }
   }
@@ -129,22 +125,24 @@ class ServerResponseImpl {
     if (this._sent) return Promise.resolve(false);
     this.markSent();
     var requireAck = (_options$requireAck = options === null || options === void 0 ? void 0 : options.requireAck) !== null && _options$requireAck !== void 0 ? _options$requireAck : false;
-    var expectedAckMeta = options === null || options === void 0 ? void 0 : options.ackMeta;
+    /**
+     * When requireAck is enabled, attach a unique ack payload by default so ACK can be
+     * unambiguously associated with this send.
+     *
+     * NOTE: ack is an internal reserved field (not part of public API).
+     */
+    var expectedAck = (0, _endpoint.buildExpectedAck)(requireAck, options === null || options === void 0 ? void 0 : options.ack);
     try {
       // If acknowledgment not required, send directly and return true
       if (!requireAck) {
-        this.sendMessage((0, _utils.createPostMessage)(_constants.MessageType.RESPONSE, this.requestId, {
+        this.sendResponseMessage({
           path: this.path,
-          secretKey: this.secretKey,
           data,
           status: this.statusCode,
           statusText: (0, _constants.getStatusText)(this.statusCode),
           headers: this.headers,
-          requireAck: false,
-          role: _constants.MessageRole.SERVER,
-          creatorId: this.serverId,
-          targetId: this.targetId
-        }));
+          requireAck: false
+        });
         return Promise.resolve(true);
       }
 
@@ -156,25 +154,21 @@ class ServerResponseImpl {
               resolve(false);
               return;
             }
-            if (expectedAckMeta !== undefined && !(0, _ackMeta.isAckMetaEqual)(expectedAckMeta, receivedAckMeta)) {
+            if (!(0, _endpoint.isExpectedAckMatch)(expectedAck, receivedAckMeta)) {
               resolve(false);
               return;
             }
             resolve(true);
           });
-          this.sendMessage((0, _utils.createPostMessage)(_constants.MessageType.RESPONSE, this.requestId, {
+          this.sendResponseMessage({
             path: this.path,
-            secretKey: this.secretKey,
             data,
             status: this.statusCode,
             statusText: (0, _constants.getStatusText)(this.statusCode),
             headers: this.headers,
             requireAck: true,
-            ackMeta: expectedAckMeta,
-            role: _constants.MessageRole.SERVER,
-            creatorId: this.serverId,
-            targetId: this.targetId
-          }));
+            ack: expectedAck
+          });
         } catch (error) {
           // If window is closed, reject immediately
           if ((error === null || error === void 0 ? void 0 : error.code) === _constants.ErrorCode.TARGET_WINDOW_CLOSED) {
@@ -201,47 +195,59 @@ class ServerResponseImpl {
    */
   send(data, options) {
     var _this = this;
-    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
-      var fileOptions;
-      return _regenerator.default.wrap(function (_context) {
-        while (1) switch (_context.prev = _context.next) {
+    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 (!_this._sent) {
-              _context.next = 1;
+              _context2.next = 1;
               break;
             }
-            return _context.abrupt("return", Promise.resolve(false));
+            return _context2.abrupt("return", Promise.resolve(false));
           case 1:
-            if (!(0, _stream.isIframeWritableStream)(data)) {
-              _context.next = 3;
-              break;
-            }
-            _context.next = 2;
-            return _this.sendStream(data);
+            return _context2.abrupt("return", _this.peer.send({
+              data,
+              onStream: function () {
+                var _onStream = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee(stream) {
+                  return _regenerator.default.wrap(function (_context) {
+                    while (1) switch (_context.prev = _context.next) {
+                      case 0:
+                        _context.next = 1;
+                        return _this.sendStream(stream);
+                      case 1:
+                        return _context.abrupt("return", true);
+                      case 2:
+                      case "end":
+                        return _context.stop();
+                    }
+                  }, _callee);
+                }));
+                function onStream(_x) {
+                  return _onStream.apply(this, arguments);
+                }
+                return onStream;
+              }(),
+              onFileOrBlob: () => {
+                // Extract options for sendFile
+                var fileOptions = _objectSpread({
+                  requireAck: options === null || options === void 0 ? void 0 : options.requireAck
+                }, typeof File !== 'undefined' && data instanceof File ? {
+                  mimeType: data.type,
+                  fileName: data.name
+                } : {});
+                return _this.sendFile(data, fileOptions);
+              },
+              onOther: () => {
+                // For other types, auto-detect and set Content-Type, then send
+                _this.ensureContentTypeIfNeeded(data);
+                return _this._sendRaw(data, options);
+              }
+            }));
           case 2:
-            return _context.abrupt("return", true);
-          case 3:
-            if (!(typeof File !== 'undefined' && data instanceof File || typeof Blob !== 'undefined' && data instanceof Blob)) {
-              _context.next = 4;
-              break;
-            }
-            // Extract options for sendFile
-            fileOptions = _objectSpread({
-              requireAck: options === null || options === void 0 ? void 0 : options.requireAck
-            }, typeof File !== 'undefined' && data instanceof File ? {
-              mimeType: data.type,
-              fileName: data.name
-            } : {});
-            return _context.abrupt("return", _this.sendFile(data, fileOptions));
-          case 4:
-            // For other types, auto-detect and set Content-Type, then send
-            _this.ensureContentTypeIfNeeded(data);
-            return _context.abrupt("return", _this._sendRaw(data, options));
-          case 5:
           case "end":
-            return _context.stop();
+            return _context2.stop();
         }
-      }, _callee);
+      }, _callee2);
     }))();
   }
   json(data, options) {
@@ -250,7 +256,6 @@ class ServerResponseImpl {
   sendFile(content, options) {
     var _this2 = this;
     return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3() {
-      var mimeType, fileName, fileContent, stream;
       return _regenerator.default.wrap(function (_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
@@ -260,77 +265,43 @@ class ServerResponseImpl {
             }
             return _context3.abrupt("return", false);
           case 1:
-            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')) {
-              _context3.next = 2;
-              break;
-            }
-            // If it's a plain string, convert to base64
-            fileContent = btoa(unescape(encodeURIComponent(content)));
-            _context3.next = 6;
-            break;
-          case 2:
-            if (!(content instanceof File)) {
-              _context3.next = 4;
-              break;
-            }
-            mimeType = content.type || mimeType;
-            fileName = fileName || content.name;
-            _context3.next = 3;
-            return (0, _utils.blobToBase64)(content);
-          case 3:
-            fileContent = _context3.sent;
-            _context3.next = 6;
-            break;
-          case 4:
-            _context3.next = 5;
-            return (0, _utils.blobToBase64)(content);
-          case 5:
-            fileContent = _context3.sent;
-          case 6:
-            // Set file-related headers
-            _this2.setHeader(_constants.HttpHeader.CONTENT_TYPE, mimeType);
-            if (fileName) {
-              _this2.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, `attachment; filename="${fileName}"`);
-            } else {
-              _this2.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, 'attachment');
-            }
-
-            // Create file stream with autoResolve enabled
-            stream = new _stream.IframeFileWritableStream({
-              filename: fileName || 'file',
-              mimeType,
+            _context3.next = 2;
+            return _this2.peer.sendFile({
+              content,
+              fileName: options === null || options === void 0 ? void 0 : options.fileName,
+              mimeType: options === null || options === void 0 ? void 0 : options.mimeType,
               chunked: false,
-              // File is sent in one chunk
               autoResolve: true,
-              // Client will automatically resolve to fileData
-              next: function () {
-                var _next = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
-                  return _regenerator.default.wrap(function (_context2) {
-                    while (1) switch (_context2.prev = _context2.next) {
-                      case 0:
-                        return _context2.abrupt("return", {
-                          data: fileContent,
-                          done: true
-                        });
-                      case 1:
-                      case "end":
-                        return _context2.stop();
-                    }
-                  }, _callee2);
-                }));
-                function next() {
-                  return _next.apply(this, arguments);
+              defaultFileName: 'file',
+              defaultMimeType: 'application/octet-stream',
+              onFileInfo: ({
+                fileName,
+                mimeType
+              }) => {
+                // Set file-related headers
+                _this2.setHeader(_constants.HttpHeader.CONTENT_TYPE, mimeType);
+                if (fileName) {
+                  _this2.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, `attachment; filename="${fileName}"`);
+                } else {
+                  _this2.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, 'attachment');
                 }
-                return next;
-              }()
-            }); // Send stream (this will handle the requireAck logic internally and set _sent)
-            _context3.next = 7;
-            return _this2.sendStream(stream);
-          case 7:
+                _this2.markSent();
+              },
+              stream: {
+                bind: {
+                  requestId: _this2.requestId,
+                  registerStreamHandler: _this2.registerStreamHandler,
+                  unregisterStreamHandler: _this2.unregisterStreamHandler,
+                  heartbeat: _this2.heartbeat,
+                  serverId: _this2.serverId,
+                  targetId: _this2.peer.defaultTargetId
+                },
+                awaitStart: true
+              }
+            });
+          case 2:
             return _context3.abrupt("return", true);
-          case 8:
+          case 3:
           case "end":
             return _context3.stop();
         }
@@ -354,27 +325,22 @@ class ServerResponseImpl {
             }
             return _context4.abrupt("return");
           case 1:
-            _this3.markSent();
-
-            // Window check is handled in MessageDispatcher when stream sends messages
-
-            // Bind stream to request context
-            stream._bind({
-              requestId: _this3.requestId,
-              targetWindow: _this3.targetWindow,
-              targetOrigin: _this3.targetOrigin,
-              secretKey: _this3.secretKey,
-              channel: _this3.channel,
-              registerStreamHandler: _this3.registerStreamHandler,
-              unregisterStreamHandler: _this3.unregisterStreamHandler,
-              heartbeat: _this3.heartbeat,
-              serverId: _this3.serverId,
-              targetId: _this3.targetId
-            });
-
-            // Start stream transmission
             _context4.next = 2;
-            return stream.start();
+            return _this3.peer.sendStream({
+              stream: stream,
+              bind: {
+                requestId: _this3.requestId,
+                registerStreamHandler: _this3.registerStreamHandler,
+                unregisterStreamHandler: _this3.unregisterStreamHandler,
+                heartbeat: _this3.heartbeat,
+                serverId: _this3.serverId,
+                targetId: _this3.peer.defaultTargetId
+              },
+              awaitStart: true,
+              beforeStart: () => {
+                _this3.markSent();
+              }
+            });
           case 2:
           case "end":
             return _context4.stop();
@@ -418,7 +384,7 @@ class ServerResponseImpl {
      * 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, {
+    var setCookieStr = (0, _cookie.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,
@@ -441,7 +407,7 @@ class ServerResponseImpl {
      * Clear specified Cookie
      * Generate an expired Set-Cookie string, client will delete this cookie upon receiving
      */
-    var setCookieStr = (0, _utils.createClearCookie)(name, {
+    var setCookieStr = (0, _cookie.createClearCookie)(name, {
       path: options === null || options === void 0 ? void 0 : options.path
     });
 

package/library/{core → impl}/server.d.ts

@@ -23,35 +23,41 @@ export interface ServerOptions {
      * Used to mitigate message explosion caused by abnormal code or attacks.
      */
     maxConcurrentRequestsPerClient?: number;
+    /** Advanced: auto-ack echo limit for ack.meta length (internal). */
+    autoAckMaxMetaLength?: number;
+    /** Advanced: auto-ack echo limit for ack.id length (internal). */
+    autoAckMaxIdLength?: number;
 }
 /**
  * RequestIframeServer implementation
  * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
  */
 export declare class RequestIframeServerImpl implements RequestIframeServer {
+    private static readonly PENDING_ACKS;
+    private static readonly PENDING_PONGS;
+    private static readonly PENDING_STREAM_REQUESTS;
+    private static readonly LIMIT_IN_FLIGHT_BY_CLIENT;
     /** Unique instance ID */
     readonly id: string;
-    private readonly dispatcher;
+    private readonly endpoint;
+    private readonly hub;
     private readonly ackTimeout;
-    private readonly versionValidator;
     private readonly handlers;
     private readonly middlewares;
     private readonly originValidator?;
     private readonly maxConcurrentRequestsPerClient;
-    private readonly inFlightByClientKey;
-    /** Responses waiting for client acknowledgment */
-    private readonly pendingAcks;
-    /** Pending pings waiting for client PONG (server -> client heartbeat) */
-    private readonly pendingPongs;
-    /** Pending requests waiting for client stream_start (streamId present) */
-    private readonly pendingStreamRequests;
-    /** Stream message handlers (streamId -> handler) for client→server streams */
-    private readonly streamHandlers;
-    /** List of functions to unregister handlers */
-    private readonly unregisterFns;
-    /** Whether it is open */
-    private _isOpen;
     constructor(options?: ServerOptions);
+    private get dispatcher();
+    /** Message isolation key (read-only) */
+    get secretKey(): string | undefined;
+    /** Whether message handling is enabled */
+    get isOpen(): boolean;
+    /** Enable message handling (register message handler) */
+    open(): void;
+    /** Disable message handling (unregister message handler, but don't release resources) */
+    close(): void;
+    /** Get the underlying MessageDispatcher */
+    get messageDispatcher(): MessageDispatcher;
     /**
      * Check whether an incoming message origin is allowed.
      */
@@ -61,45 +67,10 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
      * We intentionally include origin to prevent cross-origin collisions.
      */
     private getClientKey;
-    private incInFlight;
-    private decInFlight;
-    /**
-     * Open message processing (register message handlers)
-     */
-    open(): void;
-    /**
-     * Close message processing (unregister message handlers, but don't release channel)
-     */
-    close(): void;
-    /**
-     * Whether it is open
-     */
-    get isOpen(): boolean;
-    /**
-     * Register message handlers
-     */
-    private registerHandlers;
-    /** Handle stream_start from client (stream request with streamId) */
-    private handleStreamStart;
-    private dispatchStreamMessage;
     /**
      * Handle protocol version error
      */
     private handleVersionError;
-    /**
-     * Handle ping message
-     */
-    private handlePing;
-    private handlePong;
-    private pingClient;
-    /**
-     * Handle received acknowledgment
-     */
-    private handleReceived;
-    /** Get secretKey */
-    get secretKey(): string | undefined;
-    /** Get the underlying MessageDispatcher */
-    get messageDispatcher(): MessageDispatcher;
     private handleRequestError;
     private handleRequestResult;
     /**
@@ -112,10 +83,6 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
      * Handle request
      */
     private handleRequest;
-    /**
-     * Register pending acknowledgment response
-     */
-    private registerPendingAck;
     use(middleware: Middleware): void;
     use(path: PathMatcher, middleware: Middleware): void;
     on(path: string, handler: ServerHandler): () => void;
@@ -123,7 +90,11 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     off(path: string | string[]): void;
     map(handlers: Record<string, ServerHandler>): (() => void);
     /**
-     * Destroy (close and release channel reference)
+     * Cleanup before destroy
+     */
+    private cleanup;
+    /**
+     * Destroy server (close and release resources)
      */
     destroy(): void;
 }

package/library/impl/server.d.ts.map

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