request-iframe 0.0.1 → 0.0.3

package/library/core/response.js

@@ -1,8 +1,5 @@
 "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
@@ -18,8 +15,7 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 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; }
+var _stream = require("../stream");
 /**
  * Callback waiting for client acknowledgment
  */
@@ -28,7 +24,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
  * ServerResponse implementation
  */
 class ServerResponseImpl {
-  constructor(requestId, path, secretKey, targetWindow, targetOrigin, channel) {
+  constructor(requestId, path, secretKey, targetWindow, targetOrigin, channel, serverId, targetId) {
     (0, _defineProperty2.default)(this, "statusCode", _constants.HttpStatus.OK);
     (0, _defineProperty2.default)(this, "headers", {});
     (0, _defineProperty2.default)(this, "_sent", false);
@@ -38,6 +34,8 @@ class ServerResponseImpl {
     this.targetWindow = targetWindow;
     this.targetOrigin = targetOrigin;
     this.channel = channel;
+    this.serverId = serverId;
+    this.targetId = targetId;
   }
 
   /**
@@ -82,7 +80,10 @@ class ServerResponseImpl {
         status: this.statusCode,
         statusText: (0, _constants.getStatusText)(this.statusCode),
         headers: this.headers,
-        requireAck: false
+        requireAck: false,
+        role: _constants.MessageRole.SERVER,
+        creatorId: this.serverId,
+        targetId: this.targetId
       }));
       return Promise.resolve(true);
     }
@@ -97,7 +98,10 @@ class ServerResponseImpl {
         status: this.statusCode,
         statusText: (0, _constants.getStatusText)(this.statusCode),
         headers: this.headers,
-        requireAck: true
+        requireAck: true,
+        role: _constants.MessageRole.SERVER,
+        creatorId: this.serverId,
+        targetId: this.targetId
       }));
     });
   }
@@ -107,83 +111,92 @@ class ServerResponseImpl {
   }
   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) {
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
+      var mimeType, fileName, fileContent, stream;
+      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", false);
+            return _context2.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;
+              _context2.next = 2;
               break;
             }
             // If it's a plain string, convert to base64
-            base64Content = btoa(unescape(encodeURIComponent(content)));
-            _context.next = 6;
+            fileContent = btoa(unescape(encodeURIComponent(content)));
+            _context2.next = 6;
             break;
           case 2:
             if (!(content instanceof File)) {
-              _context.next = 4;
+              _context2.next = 4;
               break;
             }
             mimeType = content.type || mimeType;
             fileName = fileName || content.name;
-            _context.next = 3;
+            _context2.next = 3;
             return _this.blobToBase64(content);
           case 3:
-            base64Content = _context.sent;
-            _context.next = 6;
+            fileContent = _context2.sent;
+            _context2.next = 6;
             break;
           case 4:
-            _context.next = 5;
+            _context2.next = 5;
             return _this.blobToBase64(content);
           case 5:
-            base64Content = _context.sent;
+            fileContent = _context2.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;
+            // Set file-related headers
+            _this.setHeader(_constants.HttpHeader.CONTENT_TYPE, mimeType);
+            if (fileName) {
+              _this.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, `attachment; filename="${fileName}"`);
+            } else {
+              _this.setHeader(_constants.HttpHeader.CONTENT_DISPOSITION, 'attachment');
             }
-            _this.sendMessage(messageData);
-            return _context.abrupt("return", true);
+
+            // Create file stream with autoResolve enabled
+            stream = new _stream.IframeFileWritableStream({
+              filename: fileName || 'file',
+              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 _callee() {
+                  return _regenerator.default.wrap(function (_context) {
+                    while (1) switch (_context.prev = _context.next) {
+                      case 0:
+                        return _context.abrupt("return", {
+                          data: fileContent,
+                          done: true
+                        });
+                      case 1:
+                      case "end":
+                        return _context.stop();
+                    }
+                  }, _callee);
+                }));
+                function next() {
+                  return _next.apply(this, arguments);
+                }
+                return next;
+              }()
+            }); // Send stream (this will handle the requireAck logic internally and set _sent)
+            _context2.next = 7;
+            return _this.sendStream(stream);
           case 7:
-            return _context.abrupt("return", new Promise(resolve => {
-              _this._setOnAckCallback(resolve);
-              _this.sendMessage(messageData);
-            }));
+            return _context2.abrupt("return", true);
           case 8:
           case "end":
-            return _context.stop();
+            return _context2.stop();
         }
-      }, _callee);
+      }, _callee2);
     }))();
   }
 
@@ -193,15 +206,15 @@ class ServerResponseImpl {
    */
   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) {
+    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:
             if (!_this2._sent) {
-              _context2.next = 1;
+              _context3.next = 1;
               break;
             }
-            return _context2.abrupt("return");
+            return _context3.abrupt("return");
           case 1:
             _this2._sent = true;
 
@@ -211,17 +224,19 @@ class ServerResponseImpl {
               targetWindow: _this2.targetWindow,
               targetOrigin: _this2.targetOrigin,
               secretKey: _this2.secretKey,
-              channel: _this2.channel
+              channel: _this2.channel,
+              serverId: _this2.serverId,
+              targetId: _this2.targetId
             });
 
             // Start stream transmission
-            _context2.next = 2;
+            _context3.next = 2;
             return stream.start();
           case 2:
           case "end":
-            return _context2.stop();
+            return _context3.stop();
         }
-      }, _callee2);
+      }, _callee3);
     }))();
   }
   status(code) {
@@ -297,11 +312,11 @@ class ServerResponseImpl {
     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) {
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee4() {
+      return _regenerator.default.wrap(function (_context4) {
+        while (1) switch (_context4.prev = _context4.next) {
           case 0:
-            return _context3.abrupt("return", new Promise((resolve, reject) => {
+            return _context4.abrupt("return", new Promise((resolve, reject) => {
               var reader = new FileReader();
               reader.onloadend = () => {
                 var result = reader.result;
@@ -314,9 +329,9 @@ class ServerResponseImpl {
             }));
           case 1:
           case "end":
-            return _context3.stop();
+            return _context4.stop();
         }
-      }, _callee3);
+      }, _callee4);
     }))();
   }
 }

package/library/core/server-client.d.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

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

@@ -14,6 +14,8 @@ export interface ClientServerOptions {
     ackTimeout?: number;
     /** Protocol version validator (optional, uses built-in validation by default) */
     versionValidator?: VersionValidator;
+    /** Whether to automatically open when creating the client server. Default is true. */
+    autoOpen?: boolean;
 }
 /**
  * RequestIframeClientServer - Client-side message server
@@ -34,7 +36,7 @@ export declare class RequestIframeClientServer {
     private readonly unregisterFns;
     /** Whether opened */
     private _isOpen;
-    constructor(options?: ClientServerOptions);
+    constructor(options?: ClientServerOptions, instanceId?: string);
     /**
      * Open message handling (register message handlers)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../src/core/server-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAoB7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,8BAA8B;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAwB;IAE/C,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,qBAAqB;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,mBAAmB;IAYhD;;OAEG;IACI,IAAI,IAAI,IAAI;IAMnB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsExB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI/D,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED;;OAEG;IACI,mBAAmB,CACxB,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,uBAAuB,CAC5B,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,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACI,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpF;;OAEG;IACI,OAAO,IAAI,IAAI;CAavB"}
+{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../src/core/server-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAoB7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,8BAA8B;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAwB;IAE/C,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,qBAAqB;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,MAAM;IAcrE;;OAEG;IACI,IAAI,IAAI,IAAI;IAMnB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoFxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI/D,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED;;OAEG;IACI,mBAAmB,CACxB,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,uBAAuB,CAC5B,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,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACI,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpF;;OAEG;IACI,OAAO,IAAI,IAAI;CAavB"}

package/library/core/server-client.js

@@ -37,7 +37,7 @@ var _constants = require("../constants");
  * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
  */
 class RequestIframeClientServer {
-  constructor(options) {
+  constructor(options, instanceId) {
     var _options$ackTimeout, _options$versionValid;
     /** Pending responses awaiting client acknowledgment */
     (0, _defineProperty2.default)(this, "pendingAcks", new Map());
@@ -47,15 +47,17 @@ class RequestIframeClientServer {
     (0, _defineProperty2.default)(this, "unregisterFns", []);
     /** Whether opened */
     (0, _defineProperty2.default)(this, "_isOpen", false);
-    this.ackTimeout = (_options$ackTimeout = options === null || options === void 0 ? void 0 : options.ackTimeout) !== null && _options$ackTimeout !== void 0 ? _options$ackTimeout : _constants.DefaultTimeout.SERVER_ACK;
+    this.ackTimeout = (_options$ackTimeout = options === null || options === void 0 ? void 0 : options.ackTimeout) !== null && _options$ackTimeout !== void 0 ? _options$ackTimeout : _constants.DefaultTimeout.ACK;
     this.versionValidator = (_options$versionValid = options === null || options === void 0 ? void 0 : options.versionValidator) !== null && _options$versionValid !== void 0 ? _options$versionValid : _utils.isCompatibleVersion;
 
     // Get or create shared channel and create dispatcher
     var channel = (0, _cache.getOrCreateMessageChannel)(options === null || options === void 0 ? void 0 : options.secretKey);
-    this.dispatcher = new _message.MessageDispatcher(channel);
+    this.dispatcher = new _message.MessageDispatcher(channel, _constants.MessageRole.CLIENT, instanceId);
 
-    // Auto-open by default
-    this.open();
+    // Auto-open by default (unless explicitly set to false)
+    if ((options === null || options === void 0 ? void 0 : options.autoOpen) !== false) {
+      this.open();
+    }
   }
 
   /**
@@ -113,8 +115,16 @@ class RequestIframeClientServer {
     // Handle PONG messages
     this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.PONG, (data, context) => this.handlePong(data, context), handlerOptions));
 
-    // Handle stream messages (stream_*)
-    this.unregisterFns.push(this.dispatcher.registerHandler(type => type.startsWith('stream_'), (data, context) => {
+    // Handle stream_start messages (route to handleClientResponse so it reaches send callback)
+    // Note: stream_start is handled in send callback, not through streamCallback
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.STREAM_START, (data, context) => {
+      // Route to handleClientResponse so it reaches send callback
+      this.handleClientResponse(data, context);
+      // Don't call streamCallback here - stream_start is handled in send callback
+    }, handlerOptions));
+
+    // Handle other stream messages (stream_data, stream_end, etc.)
+    this.unregisterFns.push(this.dispatcher.registerHandler(type => type.startsWith('stream_') && type !== _constants.MessageType.STREAM_START, (data, context) => {
       var _this$streamCallback;
       return (_this$streamCallback = this.streamCallback) === null || _this$streamCallback === void 0 ? void 0 : _this$streamCallback.call(this, data, context);
     }, handlerOptions));
@@ -142,8 +152,8 @@ class RequestIframeClientServer {
       if (pending.origin && pending.origin !== '*' && context.origin !== pending.origin) {
         return;
       }
-      // ack and async don't delete pending
-      if (data.type === _constants.MessageType.ACK || data.type === _constants.MessageType.ASYNC) {
+      // ack, async, and stream_start don't delete pending (stream_start needs to keep pending for stream_data/stream_end)
+      if (data.type === _constants.MessageType.ACK || data.type === _constants.MessageType.ASYNC || data.type === _constants.MessageType.STREAM_START) {
         pending.resolve(data);
         return;
       }

package/library/core/server.d.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/library/core/server.d.ts

@@ -6,16 +6,22 @@ import { MessageDispatcher, VersionValidator } from '../message';
 export interface ServerOptions {
     /** Message isolation secret key */
     secretKey?: string;
+    /** Custom server instance ID (if specified, server will use this ID instead of generating one) */
+    id?: string;
     /** ACK timeout duration */
     ackTimeout?: number;
     /** Protocol version validator (optional, uses built-in validator by default) */
     versionValidator?: VersionValidator;
+    /** Whether to automatically open when creating the server. Default is true. */
+    autoOpen?: boolean;
 }
 /**
  * RequestIframeServer implementation
  * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
  */
 export declare class RequestIframeServerImpl implements RequestIframeServer {
+    /** Unique instance ID */
+    readonly id: string;
     private readonly dispatcher;
     private readonly ackTimeout;
     private readonly versionValidator;
@@ -60,6 +66,8 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     get secretKey(): string | undefined;
     /** Get the underlying MessageDispatcher */
     get messageDispatcher(): MessageDispatcher;
+    private handleRequestError;
+    private handleRequestResult;
     /**
      * Handle request
      */
@@ -70,10 +78,10 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     private registerPendingAck;
     use(middleware: Middleware): void;
     use(path: PathMatcher, middleware: Middleware): void;
-    on(path: string, handler: ServerHandler): void;
+    on(path: string, handler: ServerHandler): () => void;
     private runMiddlewares;
-    off(path: string): void;
-    map(handlers: Record<string, ServerHandler>): void;
+    off(path: string | string[]): void;
+    map(handlers: Record<string, ServerHandler>): (() => void);
     /**
      * Destroy (close and release channel reference)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA8BjF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,aAAa;IAY1C;;OAEG;IACI,IAAI,IAAI,IAAI;IAMnB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IA2HrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAanB,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IACjC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAepD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIrD,OAAO,CAAC,cAAc;IA4Cf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvB,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAMzD;;OAEG;IACI,OAAO,IAAI,IAAI;CAgBvB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAiCjF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,yBAAyB;IACzB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,aAAa;IAgB1C;;OAEG;IACI,IAAI,IAAI,IAAI;IAMnB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoHrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAanB,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IACjC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAepD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI;IAU3D,OAAO,CAAC,cAAc;IA4Cf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAYlC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC;IAUjE;;OAEG;IACI,OAAO,IAAI,IAAI;CAgBvB"}