request-iframe 0.0.3 → 0.0.4

package/library/__tests__/stream.test.ts

@@ -1,13 +1,15 @@
 /**
  * Stream functionality tests
  */
+import type { MessageChannel } from '../message';
 import {
   IframeWritableStream,
   IframeReadableStream,
   IframeFileWritableStream,
   IframeFileReadableStream,
   isIframeReadableStream,
-  isIframeFileStream,
+  isIframeFileReadableStream,
+  isIframeFileWritableStream,
   StreamMessageHandler
 } from '../stream';
 
@@ -15,12 +17,17 @@ describe('Stream', () => {
   describe('IframeWritableStream', () => {
     let mockTargetWindow: Window;
     let mockPostMessage: jest.Mock;
+    /** Mock channel: only send() is used by WritableStream */
+    let mockChannel: MessageChannel;
 
     beforeEach(() => {
       mockPostMessage = jest.fn();
       mockTargetWindow = {
         postMessage: mockPostMessage
       } as any;
+      mockChannel = {
+        send: (target: Window, message: any, origin: string) => target.postMessage(message, origin)
+      } as unknown as MessageChannel;
     });
 
     it('should create stream with default options', () => {
@@ -69,7 +76,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -98,7 +106,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -115,7 +124,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -136,7 +146,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -159,7 +170,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -174,7 +186,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       stream.cancel('User cancelled');
@@ -192,7 +205,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       // Manually set state to ended (simulating already ended)
@@ -237,7 +251,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       stream.cancel('User cancelled');
@@ -261,7 +276,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       await stream.start();
@@ -284,7 +300,8 @@ describe('Stream', () => {
         requestId: 'req-123',
         targetWindow: mockTargetWindow,
         targetOrigin: 'https://example.com',
-        secretKey: 'test'
+        secretKey: 'test',
+        channel: mockChannel
       });
 
       const startPromise = stream.start();
@@ -637,14 +654,28 @@ describe('Stream', () => {
       expect(isIframeReadableStream('string')).toBe(false);
     });
 
-    it('isIframeFileStream should return true for IframeFileReadableStream', () => {
+    it('isIframeFileReadableStream should return true for IframeFileReadableStream', () => {
       const stream = new IframeFileReadableStream('id', 'reqId', mockHandler);
-      expect(isIframeFileStream(stream)).toBe(true);
+      expect(isIframeFileReadableStream(stream)).toBe(true);
     });
 
-    it('isIframeFileStream should return false for regular IframeReadableStream', () => {
+    it('isIframeFileReadableStream should return false for regular IframeReadableStream', () => {
       const stream = new IframeReadableStream('id', 'reqId', mockHandler);
-      expect(isIframeFileStream(stream)).toBe(false);
+      expect(isIframeFileReadableStream(stream)).toBe(false);
+    });
+
+    it('isIframeFileWritableStream should return true for IframeFileWritableStream', () => {
+      const stream = new IframeFileWritableStream({
+        filename: 'test.txt',
+        mimeType: 'text/plain',
+        next: async () => ({ data: btoa('test'), done: true })
+      });
+      expect(isIframeFileWritableStream(stream)).toBe(true);
+    });
+
+    it('isIframeFileWritableStream should return false for regular IframeWritableStream', () => {
+      const stream = new IframeWritableStream();
+      expect(isIframeFileWritableStream(stream)).toBe(false);
     });
   });
 });

package/library/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAO1F;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CA+CrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKtE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAO1F;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CAgDrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKtE"}

package/library/api/client.js

@@ -55,6 +55,7 @@ function requestIframeClient(target, options) {
     ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
     timeout: options === null || options === void 0 ? void 0 : options.timeout,
     asyncTimeout: options === null || options === void 0 ? void 0 : options.asyncTimeout,
+    returnData: options === null || options === void 0 ? void 0 : options.returnData,
     headers: options === null || options === void 0 ? void 0 : options.headers
   }, instanceId);
 

package/library/constants/messages.d.ts

@@ -33,6 +33,8 @@ declare const defaultMessages: {
     readonly ERROR: "Error";
     /** Client errors */
     readonly IFRAME_NOT_READY: "iframe.contentWindow is not available";
+    /** ClientServer warnings */
+    readonly CLIENT_SERVER_IGNORED_MESSAGE_WHEN_CLOSED: "Ignored message because client server is closed/destroyed (type: {0}, requestId: {1})";
     /** Stream related messages */
     readonly STREAM_NOT_BOUND: "Stream is not bound to a request context";
     readonly STREAM_ALREADY_STARTED: "Stream has already started";

package/library/constants/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/constants/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,QAAA,MAAM,eAAe;IACnB,8BAA8B;;;;IAK9B,4BAA4B;;;;;IAM5B,qBAAqB;;;;IAKrB,8BAA8B;;;;;;IAO9B,oBAAoB;;IAGpB,8BAA8B;;;;;;;IAQ9B,8BAA8B;;;;;;;;;;;;;;;;;IAkB9B,8BAA8B;;;;;;;;;;;;;;;;;;CAkBtB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAC;AAOtD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAIxD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAE/E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAKpF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAElE"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/constants/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,QAAA,MAAM,eAAe;IACnB,8BAA8B;;;;IAK9B,4BAA4B;;;;;IAM5B,qBAAqB;;;;IAKrB,8BAA8B;;;;;;IAO9B,oBAAoB;;IAGpB,4BAA4B;;IAI5B,8BAA8B;;;;;;;IAQ9B,8BAA8B;;;;;;;;;;;;;;;;;IAkB9B,8BAA8B;;;;;;;;;;;;;;;;;;CAkBtB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAC;AAOtD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAIxD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAE/E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAKpF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAElE"}

package/library/constants/messages.js

@@ -53,6 +53,8 @@ var defaultMessages = {
   ERROR: 'Error',
   /** Client errors */
   IFRAME_NOT_READY: 'iframe.contentWindow is not available',
+  /** ClientServer warnings */
+  CLIENT_SERVER_IGNORED_MESSAGE_WHEN_CLOSED: 'Ignored message because client server is closed/destroyed (type: {0}, requestId: {1})',
   /** Stream related messages */
   STREAM_NOT_BOUND: 'Stream is not bound to a request context',
   STREAM_ALREADY_STARTED: 'Stream has already started',

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

@@ -30,6 +30,10 @@ export declare class RequestIframeClientServer {
     private readonly pendingAcks;
     /** Pending requests awaiting response */
     private readonly pendingRequests;
+    /**
+     * Avoid spamming logs for the same requestId when closed/destroyed
+     */
+    private readonly warnedMissingPendingWhenClosed;
     /** Stream message callback */
     private streamCallback?;
     /** List of unregister handler functions */

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

@@ -1 +1 @@
-{"version":3,"file":"client-server.d.ts","sourceRoot":"","sources":["../../src/core/client-server.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"}
+{"version":3,"file":"client-server.d.ts","sourceRoot":"","sources":["../../src/core/client-server.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;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAqB;IAEpE,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;IAmFxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoC5B;;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;CAcvB"}

package/library/core/client-server.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.RequestIframeClientServer = void 0;
 require("core-js/modules/es.array.iterator.js");
 require("core-js/modules/es.map.js");
+require("core-js/modules/es.set.js");
 require("core-js/modules/es.string.starts-with.js");
 require("core-js/modules/web.dom-collections.for-each.js");
 require("core-js/modules/web.dom-collections.iterator.js");
@@ -43,6 +44,10 @@ class RequestIframeClientServer {
     (0, _defineProperty2.default)(this, "pendingAcks", new Map());
     /** Pending requests awaiting response */
     (0, _defineProperty2.default)(this, "pendingRequests", new Map());
+    /**
+     * Avoid spamming logs for the same requestId when closed/destroyed
+     */
+    (0, _defineProperty2.default)(this, "warnedMissingPendingWhenClosed", new Set());
     /** List of unregister handler functions */
     (0, _defineProperty2.default)(this, "unregisterFns", []);
     /** Whether opened */
@@ -97,31 +102,30 @@ class RequestIframeClientServer {
       onVersionError: this.handleVersionError.bind(this)
     };
 
+    // Bind handleClientResponse to ensure correct 'this' context
+    var boundHandleClientResponse = this.handleClientResponse.bind(this);
+
     // Handle ACK messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ACK, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ACK, boundHandleClientResponse, handlerOptions));
 
     // Handle ASYNC messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ASYNC, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ASYNC, boundHandleClientResponse, handlerOptions));
 
     // Handle RESPONSE messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RESPONSE, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RESPONSE, boundHandleClientResponse, handlerOptions));
 
     // Handle ERROR messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ERROR, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ERROR, boundHandleClientResponse, handlerOptions));
 
     // Handle RECEIVED messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RECEIVED, data => this.handleReceived(data), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RECEIVED, this.handleReceived.bind(this), handlerOptions));
 
     // Handle PONG messages
-    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.PONG, (data, context) => this.handlePong(data, context), handlerOptions));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.PONG, this.handlePong.bind(this), handlerOptions));
 
     // 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));
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.STREAM_START, boundHandleClientResponse, 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) => {
@@ -147,20 +151,38 @@ class RequestIframeClientServer {
    */
   handleClientResponse(data, context) {
     var pending = this.pendingRequests.get(data.requestId);
-    if (pending) {
-      // Validate origin
-      if (pending.origin && pending.origin !== '*' && context.origin !== pending.origin) {
-        return;
-      }
-      // 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;
+    if (!pending) {
+      /**
+       * Pending request not found - ignore by default.
+       *
+       * If client server is already closed/destroyed, emit a warning to help debugging:
+       * this usually means the client was recreated/unmounted before the response arrived.
+       */
+      if (!this._isOpen) {
+        var key = data.requestId;
+        if (!this.warnedMissingPendingWhenClosed.has(key)) {
+          this.warnedMissingPendingWhenClosed.add(key);
+          // eslint-disable-next-line no-console
+          console.warn((0, _constants.formatMessage)(_constants.Messages.CLIENT_SERVER_IGNORED_MESSAGE_WHEN_CLOSED, data.type, data.requestId));
+        }
       }
-      // response and error delete pending
-      this.pendingRequests.delete(data.requestId);
+      return;
+    }
+
+    // Validate origin
+    if (pending.origin && pending.origin !== '*' && context.origin !== pending.origin) {
+      return;
+    }
+
+    // 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;
     }
+
+    // response and error delete pending
+    this.pendingRequests.delete(data.requestId);
+    pending.resolve(data);
   }
 
   /**
@@ -257,6 +279,7 @@ class RequestIframeClientServer {
     this.pendingRequests.clear();
     this.pendingAcks.forEach(pending => clearTimeout(pending.timeoutId));
     this.pendingAcks.clear();
+    this.warnedMissingPendingWhenClosed.clear();
 
     // Destroy dispatcher and release channel reference
     this.dispatcher.destroy();

package/library/core/client.d.ts

@@ -1,7 +1,7 @@
 import { RequestOptions, Response, RequestIframeClient, RequestDefaults, HeadersConfig } from '../types';
 import { RequestInterceptorManager, ResponseInterceptorManager } from '../interceptors';
 import { RequestIframeClientServer } from './client-server';
-import { StreamMessageHandler, StreamMessageData } from '../stream';
+import { IframeWritableStream, StreamMessageHandler, StreamMessageData } from '../stream';
 /**
  * Client configuration options
  */
@@ -19,7 +19,7 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
         request: RequestInterceptorManager;
         response: ResponseInterceptorManager;
     };
-    private readonly targetWindow;
+    readonly targetWindow: Window;
     private readonly targetOrigin;
     private readonly server;
     private readonly secretKey?;
@@ -27,6 +27,8 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
     private readonly defaultAckTimeout;
     private readonly defaultTimeout;
     private readonly defaultAsyncTimeout;
+    /** Default returnData configuration */
+    private readonly defaultReturnData;
     /** Initial headers configuration */
     private readonly initialHeaders?;
     /**
@@ -64,17 +66,42 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      * Resolve header value (handle function type headers)
      */
     private resolveHeaderValue;
+    /**
+     * Detect Content-Type for request body
+     */
+    private detectContentTypeForBody;
+    /**
+     * Check if header exists (case-insensitive)
+     */
+    private hasHeader;
     /**
      * Merge and resolve headers (initial headers + request headers)
      * Request headers take precedence over initial headers
+     * Also auto-detects and sets Content-Type if not already set
      */
     private mergeHeaders;
     /**
      * Check if server is reachable
      */
     isConnect(): Promise<boolean>;
-    send<T = any>(path: string, body?: Record<string, any>, options?: RequestOptions): Promise<Response<T>>;
-    private prefixPath;
+    send<T = any>(path: string, body?: any, options?: RequestOptions): Promise<Response<T> | T>;
+    /**
+     * Send file as request body (stream only; server receives stream or auto-resolved File/Blob via autoResolve).
+     */
+    sendFile<T = any>(path: string, content: string | Blob | File, options?: RequestOptions & {
+        mimeType?: string;
+        fileName?: string;
+        autoResolve?: boolean;
+    }): Promise<Response<T> | T>;
+    /**
+     * Send stream as request body (server receives readable stream).
+     * Sends REQUEST with streamId and stream: true, then starts the writable stream.
+     */
+    sendStream<T = any>(path: string, stream: IframeWritableStream, options?: RequestOptions): Promise<Response<T> | T>;
+    /**
+     * Internal: send REQUEST and wait for response (used by send, sendFile, sendStream).
+     */
+    private _sendRequest;
     /**
      * Get internal server instance (for debugging)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,QAAQ,EAGR,mBAAmB,EACnB,eAAe,EACf,aAAa,EAEd,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAG3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAY5D,OAAO,EAGL,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB,EAAE,oBAAoB;IACvF,yBAAyB;IACzB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAEpB,YAAY;;;MAGjB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAgB;IAEhD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAkC;IAEtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;IAEvF;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAC,CAAS;gBAG/B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,aAAa,EACvB,UAAU,CAAC,EAAE,MAAM;IAsBrB;;OAEG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;IAIhG;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO/C,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAItC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACI,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IA+CvB,IAAI,CAAC,CAAC,GAAG,GAAG,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAuWvB,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACI,SAAS,IAAI,yBAAyB;IAI7C;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACI,IAAI,IAAI,IAAI;IAInB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,OAAO,IAAI,IAAI;IAetB;;;OAGG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOxD;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjE;;;;;OAKG;IACI,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,IAAI;IAgBP;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD;;OAEG;IACI,YAAY,IAAI,IAAI;CAG5B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}