request-iframe 0.0.1 → 0.0.3

package/library/stream/file-stream.js

@@ -188,12 +188,13 @@ class IframeFileReadableStream extends _readableStream.IframeReadableStream {
   }
 
   /**
-   * Read as ArrayBuffer
+   * Read as File
+   * @param fileName Optional file name (if not provided, uses stream's filename)
    */
-  readAsArrayBuffer() {
+  readAsFile(fileName) {
     var _this2 = this;
     return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
-      var data, buffer;
+      var data, buffer, name;
       return _regenerator.default.wrap(function (_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
@@ -201,10 +202,12 @@ class IframeFileReadableStream extends _readableStream.IframeReadableStream {
             return _this2.read();
           case 1:
             data = _context2.sent;
-            // Create a new ArrayBuffer copy
-            buffer = new ArrayBuffer(data.byteLength);
-            new Uint8Array(buffer).set(data);
-            return _context2.abrupt("return", buffer);
+            // Use slice to create a pure ArrayBuffer copy to avoid type issues
+            buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+            name = fileName || _this2.filename || 'file';
+            return _context2.abrupt("return", new File([buffer], name, {
+              type: _this2.mimeType || 'application/octet-stream'
+            }));
           case 2:
           case "end":
             return _context2.stop();
@@ -214,12 +217,12 @@ class IframeFileReadableStream extends _readableStream.IframeReadableStream {
   }
 
   /**
-   * Read as Data URL
+   * Read as ArrayBuffer
    */
-  readAsDataURL() {
+  readAsArrayBuffer() {
     var _this3 = this;
     return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3() {
-      var data, base64;
+      var data, buffer;
       return _regenerator.default.wrap(function (_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
@@ -227,8 +230,10 @@ class IframeFileReadableStream extends _readableStream.IframeReadableStream {
             return _this3.read();
           case 1:
             data = _context3.sent;
-            base64 = uint8ArrayToBase64(data);
-            return _context3.abrupt("return", `data:${_this3.mimeType || 'application/octet-stream'};base64,${base64}`);
+            // Create a new ArrayBuffer copy
+            buffer = new ArrayBuffer(data.byteLength);
+            new Uint8Array(buffer).set(data);
+            return _context3.abrupt("return", buffer);
           case 2:
           case "end":
             return _context3.stop();
@@ -236,5 +241,29 @@ class IframeFileReadableStream extends _readableStream.IframeReadableStream {
       }, _callee3);
     }))();
   }
+
+  /**
+   * Read as Data URL
+   */
+  readAsDataURL() {
+    var _this4 = this;
+    return (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee4() {
+      var data, base64;
+      return _regenerator.default.wrap(function (_context4) {
+        while (1) switch (_context4.prev = _context4.next) {
+          case 0:
+            _context4.next = 1;
+            return _this4.read();
+          case 1:
+            data = _context4.sent;
+            base64 = uint8ArrayToBase64(data);
+            return _context4.abrupt("return", `data:${_this4.mimeType || 'application/octet-stream'};base64,${base64}`);
+          case 2:
+          case "end":
+            return _context4.stop();
+        }
+      }, _callee4);
+    }))();
+  }
 }
 exports.IframeFileReadableStream = IframeFileReadableStream;

package/library/stream/index.d.js

@@ -0,0 +1,58 @@
+"use strict";
+
+require("core-js/modules/web.dom-collections.for-each.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  IframeWritableStream: true,
+  IframeFileWritableStream: true,
+  IframeFileReadableStream: true,
+  IframeReadableStream: true,
+  StreamMessageHandler: true
+};
+Object.defineProperty(exports, "IframeFileReadableStream", {
+  enumerable: true,
+  get: function get() {
+    return _fileStream.IframeFileReadableStream;
+  }
+});
+Object.defineProperty(exports, "IframeFileWritableStream", {
+  enumerable: true,
+  get: function get() {
+    return _fileStream.IframeFileWritableStream;
+  }
+});
+Object.defineProperty(exports, "IframeReadableStream", {
+  enumerable: true,
+  get: function get() {
+    return _readableStream.IframeReadableStream;
+  }
+});
+Object.defineProperty(exports, "IframeWritableStream", {
+  enumerable: true,
+  get: function get() {
+    return _writableStream.IframeWritableStream;
+  }
+});
+Object.defineProperty(exports, "StreamMessageHandler", {
+  enumerable: true,
+  get: function get() {
+    return _readableStream.StreamMessageHandler;
+  }
+});
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _types[key];
+    }
+  });
+});
+var _writableStream = require("./writable-stream");
+var _fileStream = require("./file-stream");
+var _readableStream = require("./readable-stream");

package/library/stream/readable-stream.d.js

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

package/library/stream/readable-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readable-stream.d.ts","sourceRoot":"","sources":["../../src/stream/readable-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,yBAAyB;IACzB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,mBAAmB;IACnB,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,oBAAoB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAC5E,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/C,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,WAAW,CAAC,CAAqB;IACzC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,eAAe,CAAC,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAGlC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,oBAAoB,EACpC,OAAO,GAAE,qBAA0B;IAcrC,uBAAuB;IACvB,IAAW,KAAK,IAAI,WAAW,CAE9B;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC;IAIlC;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,CAAC;IAW1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACI,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IAiBzB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAoBjD;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBpC;;OAEG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAOxC;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAGvD"}
+{"version":3,"file":"readable-stream.d.ts","sourceRoot":"","sources":["../../src/stream/readable-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,yBAAyB;IACzB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,mBAAmB;IACnB,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,oBAAoB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;IAC5E,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/C,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,WAAW,CAAC,CAAqB;IACzC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,eAAe,CAAC,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAGlC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,oBAAoB,EACpC,OAAO,GAAE,qBAA0B;IAcrC,uBAAuB;IACvB,IAAW,KAAK,IAAI,WAAW,CAE9B;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC;IAIlC;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,CAAC;IAW1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACI,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IAiBzB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAoBjD;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBpC;;OAEG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAOxC;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAGvD"}

package/library/stream/readable-stream.js

@@ -12,13 +12,13 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _utils = require("../utils");
 var _constants = require("../constants");
-/**
- * Stream message handler interface
+/**
+ * Stream message handler interface
  */
 
-/**
- * IframeReadableStream - Client-side readable stream
- * Used to receive stream data sent from the server
+/**
+ * IframeReadableStream - Client-side readable stream
+ * Used to receive stream data sent from the server
  */
 class IframeReadableStream {
   constructor(streamId, requestId, messageHandler, options = {}) {
@@ -42,8 +42,8 @@ class IframeReadableStream {
     return this._state;
   }
 
-  /**
-   * Handle stream message
+  /**
+   * Handle stream message
    */
   handleStreamMessage(data) {
     switch (data.type) {
@@ -62,8 +62,8 @@ class IframeReadableStream {
     }
   }
 
-  /**
-   * Handle data chunk (internal method)
+  /**
+   * Handle data chunk (internal method)
    */
   handleData(data, done) {
     if (this._state !== _constants.StreamState.PENDING && this._state !== _constants.StreamState.STREAMING) return;
@@ -75,15 +75,15 @@ class IframeReadableStream {
     }
   }
 
-  /**
-   * Decode data (subclasses can override, e.g., FileStream needs Base64 decoding)
+  /**
+   * Decode data (subclasses can override, e.g., FileStream needs Base64 decoding)
    */
   decodeData(data) {
     return data;
   }
 
-  /**
-   * Stream ended (internal handling)
+  /**
+   * Stream ended (internal handling)
    */
   handleEnd() {
     var _this$onEndCallback;
@@ -100,8 +100,8 @@ class IframeReadableStream {
     (_this$onEndCallback = this.onEndCallback) === null || _this$onEndCallback === void 0 || _this$onEndCallback.call(this);
   }
 
-  /**
-   * Merge data chunks (subclasses can override)
+  /**
+   * Merge data chunks (subclasses can override)
    */
   mergeChunks() {
     if (this.chunks.length === 0) {
@@ -114,8 +114,8 @@ class IframeReadableStream {
     return this.chunks;
   }
 
-  /**
-   * Stream error (internal method)
+  /**
+   * Stream error (internal method)
    */
   handleError(error) {
     var _this$onErrorCallback;
@@ -130,8 +130,8 @@ class IframeReadableStream {
     (_this$onErrorCallback = this.onErrorCallback) === null || _this$onErrorCallback === void 0 || _this$onErrorCallback.call(this, error);
   }
 
-  /**
-   * Stream cancelled (internal method)
+  /**
+   * Stream cancelled (internal method)
    */
   handleCancel(reason) {
     var _this$onErrorCallback2;
@@ -147,8 +147,8 @@ class IframeReadableStream {
     (_this$onErrorCallback2 = this.onErrorCallback) === null || _this$onErrorCallback2 === void 0 || _this$onErrorCallback2.call(this, error);
   }
 
-  /**
-   * Read all data
+  /**
+   * Read all data
    */
   read() {
     return new Promise((resolve, reject) => {
@@ -165,8 +165,8 @@ class IframeReadableStream {
     });
   }
 
-  /**
-   * Async iterator
+  /**
+   * Async iterator
    */
   [Symbol.asyncIterator]() {
     var index = 0;
@@ -210,8 +210,8 @@ class IframeReadableStream {
     };
   }
 
-  /**
-   * Cancel stream
+  /**
+   * Cancel stream
    */
   cancel(reason) {
     if (this._state !== _constants.StreamState.PENDING && this._state !== _constants.StreamState.STREAMING) return;
@@ -223,14 +223,16 @@ class IframeReadableStream {
       body: {
         streamId: this.streamId,
         reason
-      }
+      },
+      role: _constants.MessageRole.CLIENT,
+      creatorId: this.messageHandler.id
     });
     this.messageHandler.postMessage(message);
     this.messageHandler.unregisterStreamHandler(this.streamId);
   }
 
-  /**
-   * Listen for stream end
+  /**
+   * Listen for stream end
    */
   onEnd(callback) {
     this.onEndCallback = callback;
@@ -239,8 +241,8 @@ class IframeReadableStream {
     }
   }
 
-  /**
-   * Listen for stream error
+  /**
+   * Listen for stream error
    */
   onError(callback) {
     this.onErrorCallback = callback;

package/library/stream/types.d.js

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

package/library/stream/types.d.ts

@@ -27,6 +27,11 @@ export interface WritableStreamOptions {
     next?: () => Promise<StreamChunk> | StreamChunk;
     /** Stream metadata */
     metadata?: Record<string, any>;
+    /**
+     * Whether to auto-resolve on client side
+     * If true, client will automatically read the stream and return fileData instead of stream
+     */
+    autoResolve?: boolean;
 }
 /**
  * Readable stream configuration options
@@ -75,6 +80,12 @@ export interface StreamBindContext {
     secretKey?: string;
     /** MessageChannel for sending messages (optional, uses direct postMessage if not provided) */
     channel?: MessageChannel;
+    /** Server instance ID (for server-side streams, used as creatorId) */
+    serverId?: string;
+    /** Client instance ID (for client-side streams, used as creatorId) */
+    clientId?: string;
+    /** Target instance ID (for routing messages to the correct instance) */
+    targetId?: string;
 }
 /**
  * Stream state
@@ -136,6 +147,8 @@ export interface IIframeFileReadableStream extends IIframeReadableStream<Uint8Ar
     readonly size?: number;
     /** Read as Blob */
     readAsBlob(): Promise<Blob>;
+    /** Read as File */
+    readAsFile(fileName?: string): Promise<File>;
     /** Read as ArrayBuffer */
     readAsArrayBuffer(): Promise<ArrayBuffer>;
     /** Read as Data URL */
@@ -161,5 +174,10 @@ export interface StreamMessageData {
     reason?: string;
     /** Metadata */
     metadata?: Record<string, any>;
+    /**
+     * Whether to auto-resolve on client side
+     * If true, client will automatically read the stream and return fileData instead of stream
+     */
+    autoResolve?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/library/stream/types.d.ts.map

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

package/library/stream/writable-stream.d.js

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

package/library/stream/writable-stream.d.ts

@@ -12,6 +12,7 @@ export declare class IframeWritableStream implements IIframeWritableStream {
     private readonly iterator?;
     private readonly nextFn?;
     private readonly metadata?;
+    private readonly autoResolve?;
     constructor(options?: WritableStreamOptions);
     /** Get stream state */
     get state(): StreamState;

package/library/stream/writable-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writable-stream.d.ts","sourceRoot":"","sources":["../../src/stream/writable-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAWjB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsB;gBAE7B,OAAO,GAAE,qBAA0B;IAStD,uBAAuB;IACvB,IAAW,KAAK,IAAI,WAAW,CAE9B;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCnC;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;IAIpC;;OAEG;IACH,OAAO,CAAC,GAAG;IAOX;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAWrC"}
+{"version":3,"file":"writable-stream.d.ts","sourceRoot":"","sources":["../../src/stream/writable-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAWjB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAU;gBAEpB,OAAO,GAAE,qBAA0B;IAUtD,uBAAuB;IACvB,IAAW,KAAK,IAAI,WAAW,CAE9B;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnC;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;IAIpC;;OAEG;IACH,OAAO,CAAC,GAAG;IAOX;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAWrC"}

package/library/stream/writable-stream.js

@@ -46,6 +46,7 @@ class IframeWritableStream {
     this.iterator = options.iterator;
     this.nextFn = options.next;
     this.metadata = options.metadata;
+    this.autoResolve = options.autoResolve;
   }
 
   /** Get stream state */
@@ -72,7 +73,10 @@ class IframeWritableStream {
       secretKey: this.context.secretKey,
       body: _objectSpread({
         streamId: this.streamId
-      }, data)
+      }, data),
+      role: _constants.MessageRole.SERVER,
+      creatorId: this.context.serverId,
+      targetId: this.context.targetId
     });
 
     // Use channel if available, otherwise use direct postMessage
@@ -111,7 +115,8 @@ class IframeWritableStream {
             _this.sendMessage(_constants.MessageType.STREAM_START, {
               type: _this.type,
               chunked: _this.chunked,
-              metadata: _this.metadata
+              metadata: _this.metadata,
+              autoResolve: _this.autoResolve
             });
             _context.prev = 3;
             if (!_this.iterator) {

package/library/types/index.d.js

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

package/library/types/index.d.ts

@@ -1,25 +1,43 @@
+import { MessageRoleValue } from '../constants';
 /**
  * Request default configuration
  * Can be set when creating requestIframeClient, and can be overridden on each request
  */
 export interface RequestDefaults {
-    /** ACK confirmation timeout (milliseconds), timeout for waiting for the other party to acknowledge the message, default 500 */
+    /** ACK confirmation timeout (milliseconds), timeout for waiting for the other party to acknowledge the message, default 1000 */
     ackTimeout?: number;
     /** Request timeout (milliseconds), timeout for waiting for the server to return the result, default 5000 */
     timeout?: number;
     /** Async request timeout (milliseconds), timeout after the server indicates it's an async task, default 120000 */
     asyncTimeout?: number;
 }
+/**
+ * Headers value type (supports static value or dynamic function)
+ */
+export type HeaderValue = string | string[] | ((config: RequestConfig) => string | string[]);
+/**
+ * Headers configuration type
+ */
+export type HeadersConfig = Record<string, HeaderValue>;
 /**
  * sender.send configuration options
  */
 export interface RequestOptions extends RequestDefaults {
     /** Custom request ID */
     requestId?: string;
-    /** Request headers */
-    headers?: Record<string, string>;
+    /**
+     * Request headers (can override initial headers from RequestIframeClientOptions).
+     * Values can be static strings/arrays or functions that dynamically generate headers based on request config.
+     */
+    headers?: HeadersConfig;
     /** Request cookies */
     cookies?: Record<string, string>;
+    /**
+     * Target server instance ID
+     * If specified, the request will only be handled by the server instance with this ID.
+     * This allows clients to target a specific server instance when multiple instances exist.
+     */
+    targetId?: string;
 }
 /**
  * sender.send request configuration (internal use)
@@ -30,7 +48,7 @@ export interface RequestConfig extends RequestOptions {
     /** Request body */
     body?: Record<string, any>;
     /** Request headers */
-    headers?: Record<string, string>;
+    headers?: HeadersConfig;
     /** Request cookies */
     cookies?: Record<string, string>;
 }
@@ -48,12 +66,6 @@ export interface Response<T = any> {
     requestId: string;
     /** Response headers (Set-Cookie is a string array) */
     headers?: Record<string, string | string[]>;
-    /** File data (if response is a file) */
-    fileData?: {
-        content: string;
-        mimeType?: string;
-        fileName?: string;
-    };
     /** Stream data (if response is a stream) */
     stream?: import('../stream').IIframeReadableStream<T>;
 }
@@ -144,12 +156,6 @@ export interface PostMessageData {
     cookies?: Record<string, string>;
     /** Response data */
     data?: any;
-    /** File data (base64 encoded, used for sendFile) */
-    fileData?: {
-        content: string;
-        mimeType?: string;
-        fileName?: string;
-    };
     /** Error information */
     error?: {
         message: string;
@@ -161,6 +167,25 @@ export interface PostMessageData {
     statusText?: string;
     /** Whether client confirmation of receipt is required (for response/error messages) */
     requireAck?: boolean;
+    /**
+     * Message sender role
+     * - 'client': message sent by client
+     * - 'server': message sent by server
+     * Used to prevent message routing confusion when client and server are in the same window
+     */
+    role?: MessageRoleValue;
+    /**
+     * ID of the instance that created this message
+     * Used to identify which client/server instance created the message
+     */
+    creatorId?: string;
+    /**
+     * ID of the target instance that should handle this message
+     * - For requests: ID of the target server instance (if specified, only that server will process it)
+     * - For responses/acks: ID of the target client instance (usually the creatorId of the original request)
+     * Used to ensure messages are routed to the correct instance and avoid message confusion
+     */
+    targetId?: string;
 }
 /**
  * Server Request object (similar to express)
@@ -290,6 +315,14 @@ export type ServerEventName = 'request' | 'ack' | 'async' | 'response' | 'error'
  * Client interface
  */
 export interface RequestIframeClient {
+    /** Unique instance ID */
+    readonly id: string;
+    /** Whether message handling is enabled */
+    readonly isOpen: boolean;
+    /** Enable message handling (register message handler) */
+    open(): void;
+    /** Disable message handling (unregister message handler, but don't release resources) */
+    close(): void;
     /** Interceptors (only effective for send) */
     interceptors: {
         request: import('../interceptors').RequestInterceptorManager;
@@ -331,6 +364,8 @@ export interface RequestIframeClient {
      * Clear all cookies
      */
     clearCookies(): void;
+    /** Destroy client (close and release resources) */
+    destroy(): void;
 }
 /**
  * Client server interface (used on client side, handles responses only)
@@ -351,6 +386,8 @@ export interface RequestIframeClientServer {
  * Server interface (used on server side, handles requests and responses)
  */
 export interface RequestIframeServer {
+    /** Unique instance ID */
+    readonly id: string;
     /** Message isolation key (read-only) */
     readonly secretKey?: string;
     /** Whether message handling is enabled */
@@ -367,11 +404,11 @@ export interface RequestIframeServer {
     use(middleware: Middleware): void;
     use(path: PathMatcher, middleware: Middleware): void;
     /** Register route handler */
-    on(path: string, handler: ServerHandler): void;
+    on(path: string, handler: ServerHandler): (() => void);
     /** Unregister route handler */
-    off(path: string): void;
+    off(path: string | string[]): void;
     /** Batch register route handlers (via key: value object) */
-    map(handlers: Record<string, ServerHandler>): void;
+    map(handlers: Record<string, ServerHandler>): (() => void);
     /** Destroy server (close and release resources) */
     destroy(): void;
 }
@@ -389,6 +426,17 @@ export interface RequestIframeClientOptions extends RequestDefaults {
      * If true, logs will be printed at various points such as before and after requests.
      */
     trace?: boolean;
+    /**
+     * Initial request headers.
+     * Values can be static strings/arrays or functions that dynamically generate headers based on request config.
+     * Headers from individual requests will override these initial headers.
+     */
+    headers?: HeadersConfig;
+    /**
+     * Whether to automatically open (start message handling) when creating the client.
+     * Default is true. If set to false, you need to manually call client.open() to start message handling.
+     */
+    autoOpen?: boolean;
 }
 /**
  * requestIframeServer entry options
@@ -399,10 +447,22 @@ export interface RequestIframeServerOptions extends Pick<RequestDefaults, 'ackTi
      * If configured, automatically adds a unified prefix to the path of all messages (to avoid conflicts between different businesses), and only processes framework messages with the same secretKey.
      */
     secretKey?: string;
+    /**
+     * Custom server instance ID.
+     * If specified, the server will use this ID instead of generating a random one.
+     * Servers with the same id (and secretKey) will be cached and reused (singleton pattern).
+     * This allows clients to target a specific server instance by its ID.
+     */
+    id?: string;
     /**
      * Whether to enable trace mode.
      * If true, logs will be printed at various points such as before and after requests, server receive/respond, etc.
      */
     trace?: boolean;
+    /**
+     * Whether to automatically open (start message handling) when creating the server.
+     * Default is true. If set to false, you need to manually call server.open() to start message handling.
+     */
+    autoOpen?: boolean;
 }
 //# sourceMappingURL=index.d.ts.map