request-iframe 0.0.2 → 0.0.4

package/library/core/request.d.ts

@@ -5,13 +5,15 @@ import { MessageContext } from '../message';
  */
 export declare class ServerRequestImpl implements ServerRequest {
     body: any;
+    stream?: ServerRequest['stream'];
     headers: Record<string, string>;
     cookies: Record<string, string>;
     path: string;
+    params: Record<string, string>;
     requestId: string;
     origin: string;
     source: Window;
     res: ServerResponse;
-    constructor(data: PostMessageData, context: MessageContext, response: ServerResponse);
+    constructor(data: PostMessageData, context: MessageContext, response: ServerResponse, params?: Record<string, string>);
 }
 //# sourceMappingURL=request.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["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,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,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;CAiB3B"}
+{"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"}

package/library/core/request.js

@@ -11,7 +11,7 @@ require("core-js/modules/es.object.entries.js");
  * ServerRequest implementation
  */
 class ServerRequestImpl {
-  constructor(data, context, response) {
+  constructor(data, context, response, params = {}) {
     this.body = data.body;
     // headers may contain array values (e.g., Set-Cookie), simplified to string here
     this.headers = {};
@@ -25,6 +25,7 @@ class ServerRequestImpl {
     }
     this.cookies = data.cookies || {};
     this.path = data.path || '';
+    this.params = params;
     this.requestId = data.requestId;
     this.origin = context.origin;
     this.source = context.source;

package/library/core/response.d.ts

@@ -16,14 +16,31 @@ export declare class ServerResponseImpl implements ServerResponse {
     private readonly secretKey?;
     private readonly targetWindow;
     private readonly targetOrigin;
-    private readonly channel?;
+    private readonly channel;
+    /** 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?;
     _sent: boolean;
-    constructor(requestId: string, path: string, secretKey: string | undefined, targetWindow: Window, targetOrigin: string, channel?: MessageChannel);
+    constructor(requestId: string, path: string, secretKey: string | undefined, targetWindow: Window, targetOrigin: string, channel: MessageChannel, serverId?: string, targetId?: string);
     /**
-     * Send message via channel or direct postMessage
+     * Send message via channel
      */
     private sendMessage;
+    /**
+     * Check if header exists (case-insensitive)
+     */
+    private hasHeader;
+    /**
+     * Detect data type and return appropriate Content-Type
+     * Returns null if Content-Type should not be auto-set
+     */
+    private detectContentType;
+    /**
+     * Auto set Content-Type based on data type (only if user not set)
+     */
+    private ensureContentTypeIfNeeded;
     /**
      * Set callback waiting for client acknowledgment
      */
@@ -32,6 +49,16 @@ export declare class ServerResponseImpl implements ServerResponse {
      * Trigger client acknowledgment callback
      */
     _triggerAck(received: boolean): void;
+    /**
+     * Internal method: send raw data (used by send after type detection)
+     */
+    private _sendRaw;
+    /**
+     * Universal send method - automatically detects data type and calls appropriate method
+     * - If data is IframeWritableStream, calls sendStream
+     * - If data is File/Blob, calls sendFile
+     * - Otherwise, sends as regular data with auto-detected Content-Type
+     */
     send(data: any, options?: SendOptions): Promise<boolean>;
     json(data: any, options?: SendOptions): Promise<boolean>;
     sendFile(content: string | Blob | File, options?: SendFileOptions): Promise<boolean>;
@@ -45,7 +72,6 @@ export declare class ServerResponseImpl implements ServerResponse {
     set(name: string, value: string | number | string[]): ServerResponse;
     cookie(name: string, value: string, options?: CookieOptions): ServerResponse;
     clearCookie(name: string, options?: CookieOptions): ServerResponse;
-    private blobToBase64;
 }
 export {};
 //# sourceMappingURL=response.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5C;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/C;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAChD,UAAU,EAAE,MAAM,CAAiB;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAM;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAiB;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAc;IAC7B,KAAK,UAAS;gBAGnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,cAAc;IAU1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIrD;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAOpC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCxD,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlD,QAAQ,CACnB,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC;IAyDnB;;;OAGG;IACU,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAKpC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAwBhE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc;IAMpE,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,cAAc;IA4BV,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,GACtB,cAAc;YAkBH,YAAY;CAa3B"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGvF,OAAO,EAAE,oBAAoB,EAAoD,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5C;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/C;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAChD,UAAU,EAAE,MAAM,CAAiB;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAM;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,aAAa,CAAC,CAAc;IAC7B,KAAK,UAAS;gBAGnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,cAAc,EACvB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM;IAYnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIrD;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAO3C;;OAEG;IACH,OAAO,CAAC,QAAQ;IA8ChB;;;;;OAKG;IACU,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAiC9D,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,QAAQ,CACnB,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC;IAoDnB;;;OAGG;IACU,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAKpC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAwBhE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc;IAMpE,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,cAAc;IA4BV,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,GACtB,cAAc;CAkBlB"}

package/library/core/response.js

@@ -9,15 +9,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 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");
+var _stream = require("../stream");
 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,7 +27,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,16 +37,44 @@ class ServerResponseImpl {
     this.targetWindow = targetWindow;
     this.targetOrigin = targetOrigin;
     this.channel = channel;
+    this.serverId = serverId;
+    this.targetId = targetId;
   }
 
   /**
-   * Send message via channel or direct postMessage
+   * Send message via channel
    */
   sendMessage(message) {
-    if (this.channel) {
-      this.channel.send(this.targetWindow, message, this.targetOrigin);
-    } else {
-      this.targetWindow.postMessage(message, this.targetOrigin);
+    this.channel.send(this.targetWindow, message, this.targetOrigin);
+  }
+
+  /**
+   * Check if header exists (case-insensitive)
+   */
+  hasHeader(name) {
+    var lower = name.toLowerCase();
+    return Object.keys(this.headers).some(k => k.toLowerCase() === lower);
+  }
+
+  /**
+   * Detect data type and return appropriate Content-Type
+   * Returns null if Content-Type should not be auto-set
+   */
+  detectContentType(data) {
+    return (0, _utils.detectContentType)(data, {
+      checkStream: true,
+      isIframeWritableStream: _stream.isIframeWritableStream
+    });
+  }
+
+  /**
+   * Auto set Content-Type based on data type (only if user not set)
+   */
+  ensureContentTypeIfNeeded(data) {
+    if (this.hasHeader(_constants.HttpHeader.CONTENT_TYPE)) return;
+    var contentType = this.detectContentType(data);
+    if (contentType) {
+      this.setHeader(_constants.HttpHeader.CONTENT_TYPE, contentType);
     }
   }
 
@@ -67,7 +94,11 @@ class ServerResponseImpl {
       this.onAckCallback = undefined;
     }
   }
-  send(data, options) {
+
+  /**
+   * Internal method: send raw data (used by send after type detection)
+   */
+  _sendRaw(data, options) {
     var _options$requireAck;
     if (this._sent) return Promise.resolve(false);
     this._sent = true;
@@ -82,7 +113,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,19 +131,24 @@ 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
       }));
     });
   }
-  json(data, options) {
-    this.setHeader(_constants.HttpHeader.CONTENT_TYPE, 'application/json');
-    return this.send(data, options);
-  }
-  sendFile(content, options) {
+
+  /**
+   * Universal send method - automatically detects data type and calls appropriate method
+   * - If data is IframeWritableStream, calls sendStream
+   * - If data is File/Blob, calls sendFile
+   * - Otherwise, sends as regular data with auto-detected Content-Type
+   */
+  send(data, options) {
     var _this = this;
     return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
-      var _options$requireAck2;
-      var requireAck, base64Content, mimeType, fileName, fileHeaders, messageData;
+      var fileOptions;
       return _regenerator.default.wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
@@ -117,73 +156,131 @@ class ServerResponseImpl {
               _context.next = 1;
               break;
             }
-            return _context.abrupt("return", false);
+            return _context.abrupt("return", Promise.resolve(false));
+          case 1:
+            if (!(0, _stream.isIframeWritableStream)(data)) {
+              _context.next = 3;
+              break;
+            }
+            _context.next = 2;
+            return _this.sendStream(data);
+          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();
+        }
+      }, _callee);
+    }))();
+  }
+  json(data, options) {
+    return this.send(data, options);
+  }
+  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:
+            if (!_this2._sent) {
+              _context3.next = 1;
+              break;
+            }
+            return _context3.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;
+              _context3.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)));
+            _context3.next = 6;
             break;
           case 2:
             if (!(content instanceof File)) {
-              _context.next = 4;
+              _context3.next = 4;
               break;
             }
             mimeType = content.type || mimeType;
             fileName = fileName || content.name;
-            _context.next = 3;
-            return _this.blobToBase64(content);
+            _context3.next = 3;
+            return (0, _utils.blobToBase64)(content);
           case 3:
-            base64Content = _context.sent;
-            _context.next = 6;
+            fileContent = _context3.sent;
+            _context3.next = 6;
             break;
           case 4:
-            _context.next = 5;
-            return _this.blobToBase64(content);
+            _context3.next = 5;
+            return (0, _utils.blobToBase64)(content);
           case 5:
-            base64Content = _context.sent;
+            fileContent = _context3.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
+            _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');
             }
-            _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 _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);
+                }
+                return next;
+              }()
+            }); // Send stream (this will handle the requireAck logic internally and set _sent)
+            _context3.next = 7;
+            return _this2.sendStream(stream);
           case 7:
-            return _context.abrupt("return", new Promise(resolve => {
-              _this._setOnAckCallback(resolve);
-              _this.sendMessage(messageData);
-            }));
+            return _context3.abrupt("return", true);
           case 8:
           case "end":
-            return _context.stop();
+            return _context3.stop();
         }
-      }, _callee);
+      }, _callee3);
     }))();
   }
 
@@ -192,36 +289,38 @@ class ServerResponseImpl {
    * 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) {
+    var _this3 = this;
+    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:
-            if (!_this2._sent) {
-              _context2.next = 1;
+            if (!_this3._sent) {
+              _context4.next = 1;
               break;
             }
-            return _context2.abrupt("return");
+            return _context4.abrupt("return");
           case 1:
-            _this2._sent = true;
+            _this3._sent = true;
 
             // Bind stream to request context
             stream._bind({
-              requestId: _this2.requestId,
-              targetWindow: _this2.targetWindow,
-              targetOrigin: _this2.targetOrigin,
-              secretKey: _this2.secretKey,
-              channel: _this2.channel
+              requestId: _this3.requestId,
+              targetWindow: _this3.targetWindow,
+              targetOrigin: _this3.targetOrigin,
+              secretKey: _this3.secretKey,
+              channel: _this3.channel,
+              serverId: _this3.serverId,
+              targetId: _this3.targetId
             });
 
             // Start stream transmission
-            _context2.next = 2;
+            _context4.next = 2;
             return stream.start();
           case 2:
           case "end":
-            return _context2.stop();
+            return _context4.stop();
         }
-      }, _callee2);
+      }, _callee4);
     }))();
   }
   status(code) {
@@ -296,28 +395,5 @@ 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) {
-          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-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":["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.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;
@@ -23,6 +29,10 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     private readonly middlewares;
     /** Responses waiting for client acknowledgment */
     private readonly pendingAcks;
+    /** 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 */
@@ -44,6 +54,9 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
      * Register message handlers
      */
     private registerHandlers;
+    /** Handle stream_start from client (stream request with streamId) */
+    private handleStreamStart;
+    private dispatchStreamMessage;
     /**
      * Handle protocol version error
      */
@@ -60,6 +73,14 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     get secretKey(): string | undefined;
     /** Get the underlying MessageDispatcher */
     get messageDispatcher(): MessageDispatcher;
+    private handleRequestError;
+    private handleRequestResult;
+    /**
+     * Find matching handler and extract path parameters
+     * @param requestPath The actual request path
+     * @returns Handler function and extracted parameters, or null if not found
+     */
+    private findHandler;
     /**
      * Handle request
      */
@@ -73,7 +94,7 @@ export declare class RequestIframeServerImpl implements RequestIframeServer {
     on(path: string, handler: ServerHandler): () => void;
     private runMiddlewares;
     off(path: string | string[]): void;
-    map(handlers: Record<string, ServerHandler>): void;
+    map(handlers: Record<string, ServerHandler>): (() => void);
     /**
      * Destroy (close and release channel reference)
      */