request-iframe 0.0.2 → 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":["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,CA0CrB;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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.clearRequestIframeClientCache = clearRequestIframeClientCache;
 exports.requestIframeClient = requestIframeClient;
 var _utils = require("../utils");
-var _serverClient = require("../core/server-client");
+var _clientServer = require("../core/client-server");
 var _client = require("../core/client");
 var _debug = require("../utils/debug");
 var _constants = require("../constants");
@@ -39,19 +39,25 @@ function requestIframeClient(target, options) {
   // Determine secretKey
   var secretKey = options === null || options === void 0 ? void 0 : options.secretKey;
 
+  // Generate instance ID first (will be used by both client and server)
+  var instanceId = (0, _utils.generateInstanceId)();
+
   // Create ClientServer (internally obtains or creates a shared MessageChannel)
-  var server = new _serverClient.RequestIframeClientServer({
+  var server = new _clientServer.RequestIframeClientServer({
     secretKey,
-    ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout
-  });
+    ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
+    autoOpen: options === null || options === void 0 ? void 0 : options.autoOpen
+  }, instanceId);
 
   // Create client instance
   var client = new _client.RequestIframeClientImpl(targetWindow, targetOrigin, server, {
     secretKey,
     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
-  });
+    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);
 
   // If trace mode is enabled, register debug interceptors
   if (options !== null && options !== void 0 && options.trace) {

package/library/api/server.d.ts

@@ -4,13 +4,14 @@ import { RequestIframeServer, RequestIframeServerOptions } from '../types';
  *
  * Note:
  * - MessageChannel is cached at the window level by secretKey (ensures unique message listener)
- * - Server instances are not cached, a new instance is created on each call
+ * - If options.id is specified, the server will be cached and reused (singleton pattern)
+ * - If options.id is not specified, a new instance is created on each call
  * - This allows different versions of the library to coexist
  */
 export declare function requestIframeServer(options?: RequestIframeServerOptions): RequestIframeServer;
 /**
- * Clear MessageChannel cache (for testing or reset)
- * Note: This clears the shared message channel for the specified secretKey
+ * Clear server cache (for testing or reset)
+ * Note: This clears the cached server instances
  */
 export declare function clearRequestIframeServerCache(secretKey?: string): void;
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAI3E;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CAgBrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKtE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAK3E;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CAgCrB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKtE"}

package/library/api/server.js

@@ -7,38 +7,56 @@ exports.clearRequestIframeServerCache = clearRequestIframeServerCache;
 exports.requestIframeServer = requestIframeServer;
 var _server = require("../core/server");
 var _debug = require("../utils/debug");
+var _cache = require("../utils/cache");
 /**
  * Create a server (for receiving and handling requests)
  * 
  * Note:
  * - MessageChannel is cached at the window level by secretKey (ensures unique message listener)
- * - Server instances are not cached, a new instance is created on each call
+ * - If options.id is specified, the server will be cached and reused (singleton pattern)
+ * - If options.id is not specified, a new instance is created on each call
  * - This allows different versions of the library to coexist
  */
 function requestIframeServer(options) {
-  // Determine secretKey
+  // Determine secretKey and id
   var secretKey = options === null || options === void 0 ? void 0 : options.secretKey;
+  var id = options === null || options === void 0 ? void 0 : options.id;
+
+  // If id is specified, check cache first
+  if (id) {
+    var cached = (0, _cache.getCachedServer)(secretKey, id);
+    if (cached) {
+      return cached;
+    }
+  }
 
   // Create server (internally obtains or creates a shared MessageChannel)
   var server = new _server.RequestIframeServerImpl({
     secretKey,
-    ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout
+    id,
+    ackTimeout: options === null || options === void 0 ? void 0 : options.ackTimeout,
+    autoOpen: options === null || options === void 0 ? void 0 : options.autoOpen
   });
 
   // If trace mode is enabled, register debug listeners
   if (options !== null && options !== void 0 && options.trace) {
     (0, _debug.setupServerDebugListeners)(server);
   }
+
+  // Cache server if id is specified
+  if (id) {
+    (0, _cache.cacheServer)(server, secretKey, id);
+  }
   return server;
 }
 
 /**
- * Clear MessageChannel cache (for testing or reset)
- * Note: This clears the shared message channel for the specified secretKey
+ * Clear server cache (for testing or reset)
+ * Note: This clears the cached server instances
  */
 function clearRequestIframeServerCache(secretKey) {
-  // Now server is no longer cached, only need to clear MessageChannel cache
+  // Clear server cache
+  (0, _cache.clearServerCache)();
   // MessageChannel cleanup is handled by clearMessageChannelCache in cache.ts
-  // Empty implementation kept here to maintain API compatibility
   void secretKey;
 }

package/library/constants/index.d.ts

@@ -111,18 +111,28 @@ export declare const MessageType: {
     /** Stream cancel */
     readonly STREAM_CANCEL: "stream_cancel";
 };
+export declare const MessageRole: {
+    /** Server role */
+    readonly SERVER: "server";
+    /** Client role */
+    readonly CLIENT: "client";
+};
+export type MessageRoleValue = typeof MessageRole[keyof typeof MessageRole];
 /**
  * Default timeout configuration (milliseconds)
  */
 export declare const DefaultTimeout: {
-    /** ACK confirmation timeout: 500ms (client waiting for server confirmation) */
-    readonly ACK: 500;
+    /**
+     * ACK confirmation timeout: 1000ms (1s)
+     * Used for both client waiting for server ACK and server waiting for client RECEIVED.
+     * Increased from 500ms to accommodate slower environments or busy browsers where postMessage
+     * serialization/deserialization may take longer.
+     */
+    readonly ACK: 1000;
     /** Request timeout: 5s */
     readonly REQUEST: 5000;
     /** Async request timeout: 120s */
     readonly ASYNC: 120000;
-    /** Server waiting for client confirmation timeout: 5s (server waiting for client to confirm response received) */
-    readonly SERVER_ACK: 5000;
 };
 /**
  * HTTP Header name constants

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

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

package/library/constants/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.MessageType = exports.HttpStatusText = exports.HttpStatus = exports.HttpHeader = exports.ErrorCode = exports.DefaultTimeout = void 0;
+exports.MessageType = exports.MessageRole = exports.HttpStatusText = exports.HttpStatus = exports.HttpHeader = exports.ErrorCode = exports.DefaultTimeout = void 0;
 Object.defineProperty(exports, "Messages", {
   enumerable: true,
   get: function get() {
@@ -159,19 +159,27 @@ var MessageType = exports.MessageType = {
   /** Stream cancel */
   STREAM_CANCEL: 'stream_cancel'
 };
-
+var MessageRole = exports.MessageRole = {
+  /** Server role */
+  SERVER: 'server',
+  /** Client role */
+  CLIENT: 'client'
+};
 /**
  * Default timeout configuration (milliseconds)
  */
 var DefaultTimeout = exports.DefaultTimeout = {
-  /** ACK confirmation timeout: 500ms (client waiting for server confirmation) */
-  ACK: 500,
+  /** 
+   * ACK confirmation timeout: 1000ms (1s)
+   * Used for both client waiting for server ACK and server waiting for client RECEIVED.
+   * Increased from 500ms to accommodate slower environments or busy browsers where postMessage
+   * serialization/deserialization may take longer.
+   */
+  ACK: 1000,
   /** Request timeout: 5s */
   REQUEST: 5000,
   /** Async request timeout: 120s */
-  ASYNC: 120000,
-  /** Server waiting for client confirmation timeout: 5s (server waiting for client to confirm response received) */
-  SERVER_ACK: 5000
+  ASYNC: 120000
 };
 
 /**

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";
@@ -40,6 +42,41 @@ declare const defaultMessages: {
     readonly STREAM_ERROR: "Stream error: {0}";
     readonly STREAM_ENDED: "Stream has ended";
     readonly STREAM_READ_ERROR: "Failed to read stream data";
+    /** Debug messages - Client */
+    readonly DEBUG_CLIENT_REQUEST_START: "📤 [Client] Request Start";
+    readonly DEBUG_CLIENT_REQUEST_SUCCESS: "✅ [Client] Request Success";
+    readonly DEBUG_CLIENT_REQUEST_SUCCESS_FILE: "✅ [Client] Request Success (File)";
+    readonly DEBUG_CLIENT_REQUEST_SUCCESS_STREAM: "✅ [Client] Request Success (Stream)";
+    readonly DEBUG_CLIENT_REQUEST_FAILED: "❌ [Client] Request Failed";
+    readonly DEBUG_CLIENT_RECEIVED_ACK: "📥 [Client] Received ACK";
+    readonly DEBUG_CLIENT_RECEIVED_ASYNC: "⏳ [Client] Received ASYNC Notification";
+    readonly DEBUG_CLIENT_RECEIVED_STREAM_START: "🌊 [Client] Received Stream Start";
+    readonly DEBUG_CLIENT_RECEIVED_STREAM_DATA: "🌊 [Client] Received Stream Data";
+    readonly DEBUG_CLIENT_RECEIVED_STREAM_END: "🌊 [Client] Received Stream End";
+    readonly DEBUG_CLIENT_RECEIVED_RESPONSE: "📥 [Client] Received Response";
+    readonly DEBUG_CLIENT_RECEIVED_ERROR: "📥 [Client] Received Error";
+    readonly DEBUG_CLIENT_REQUEST_TIMEOUT: "⏱️ [Client] Request Timeout";
+    readonly DEBUG_CLIENT_SENDING_REQUEST: "📤 [Client] Sending Request";
+    readonly DEBUG_CLIENT_SENDING_PING: "📤 [Client] Sending Ping";
+    readonly DEBUG_CLIENT_SENDING_RECEIVED_ACK: "📤 [Client] Sending Received ACK";
+    /** Debug messages - Server */
+    readonly DEBUG_SERVER_RECEIVED_REQUEST: "📥 [Server] Received Request";
+    readonly DEBUG_SERVER_SETTING_STATUS_CODE: "📝 [Server] Setting Status Code";
+    readonly DEBUG_SERVER_SETTING_HEADER: "📝 [Server] Setting Header";
+    readonly DEBUG_SERVER_SENDING_RESPONSE: "📤 [Server] Sending Response";
+    readonly DEBUG_SERVER_SENDING_JSON_RESPONSE: "📤 [Server] Sending JSON Response";
+    readonly DEBUG_SERVER_SENDING_FILE: "📤 [Server] Sending File";
+    readonly DEBUG_SERVER_SENDING_STREAM: "📤 [Server] Sending Stream";
+    readonly DEBUG_SERVER_SENDING_ACK: "📤 [Server] Sending ACK";
+    readonly DEBUG_SERVER_SENDING_ASYNC: "📤 [Server] Sending ASYNC Notification";
+    readonly DEBUG_SERVER_SENDING_STREAM_START: "🌊 [Server] Sending Stream Start";
+    readonly DEBUG_SERVER_SENDING_STREAM_DATA: "🌊 [Server] Sending Stream Data";
+    readonly DEBUG_SERVER_SENDING_STREAM_END: "🌊 [Server] Sending Stream End";
+    readonly DEBUG_SERVER_SENDING_ERROR: "📤 [Server] Sending Error";
+    readonly DEBUG_SERVER_SENDING_RESPONSE_VIA_DISPATCHER: "📤 [Server] Sending Response (via dispatcher)";
+    readonly DEBUG_SERVER_HANDLING_REQUEST: "📥 [Server] Handling Request";
+    readonly DEBUG_SERVER_EXECUTING_MIDDLEWARE_CHAIN: "⚙️ [Server] Executing Middleware Chain";
+    readonly DEBUG_SERVER_MIDDLEWARE_CHAIN_COMPLETED: "✅ [Server] Middleware Chain Completed";
 };
 /**
  * Message type

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,QAAA,MAAM,eAAe;IACnB,8BAA8B;;;;IAK9B,4BAA4B;;;;;IAM5B,qBAAqB;;;;IAKrB,8BAA8B;;;;;;IAO9B,oBAAoB;;IAGpB,8BAA8B;;;;;;;CAOtB,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,13 +53,50 @@ 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',
   STREAM_CANCELLED: 'Stream was cancelled: {0}',
   STREAM_ERROR: 'Stream error: {0}',
   STREAM_ENDED: 'Stream has ended',
-  STREAM_READ_ERROR: 'Failed to read stream data'
+  STREAM_READ_ERROR: 'Failed to read stream data',
+  /** Debug messages - Client */
+  DEBUG_CLIENT_REQUEST_START: '📤 [Client] Request Start',
+  DEBUG_CLIENT_REQUEST_SUCCESS: '✅ [Client] Request Success',
+  DEBUG_CLIENT_REQUEST_SUCCESS_FILE: '✅ [Client] Request Success (File)',
+  DEBUG_CLIENT_REQUEST_SUCCESS_STREAM: '✅ [Client] Request Success (Stream)',
+  DEBUG_CLIENT_REQUEST_FAILED: '❌ [Client] Request Failed',
+  DEBUG_CLIENT_RECEIVED_ACK: '📥 [Client] Received ACK',
+  DEBUG_CLIENT_RECEIVED_ASYNC: '⏳ [Client] Received ASYNC Notification',
+  DEBUG_CLIENT_RECEIVED_STREAM_START: '🌊 [Client] Received Stream Start',
+  DEBUG_CLIENT_RECEIVED_STREAM_DATA: '🌊 [Client] Received Stream Data',
+  DEBUG_CLIENT_RECEIVED_STREAM_END: '🌊 [Client] Received Stream End',
+  DEBUG_CLIENT_RECEIVED_RESPONSE: '📥 [Client] Received Response',
+  DEBUG_CLIENT_RECEIVED_ERROR: '📥 [Client] Received Error',
+  DEBUG_CLIENT_REQUEST_TIMEOUT: '⏱️ [Client] Request Timeout',
+  DEBUG_CLIENT_SENDING_REQUEST: '📤 [Client] Sending Request',
+  DEBUG_CLIENT_SENDING_PING: '📤 [Client] Sending Ping',
+  DEBUG_CLIENT_SENDING_RECEIVED_ACK: '📤 [Client] Sending Received ACK',
+  /** Debug messages - Server */
+  DEBUG_SERVER_RECEIVED_REQUEST: '📥 [Server] Received Request',
+  DEBUG_SERVER_SETTING_STATUS_CODE: '📝 [Server] Setting Status Code',
+  DEBUG_SERVER_SETTING_HEADER: '📝 [Server] Setting Header',
+  DEBUG_SERVER_SENDING_RESPONSE: '📤 [Server] Sending Response',
+  DEBUG_SERVER_SENDING_JSON_RESPONSE: '📤 [Server] Sending JSON Response',
+  DEBUG_SERVER_SENDING_FILE: '📤 [Server] Sending File',
+  DEBUG_SERVER_SENDING_STREAM: '📤 [Server] Sending Stream',
+  DEBUG_SERVER_SENDING_ACK: '📤 [Server] Sending ACK',
+  DEBUG_SERVER_SENDING_ASYNC: '📤 [Server] Sending ASYNC Notification',
+  DEBUG_SERVER_SENDING_STREAM_START: '🌊 [Server] Sending Stream Start',
+  DEBUG_SERVER_SENDING_STREAM_DATA: '🌊 [Server] Sending Stream Data',
+  DEBUG_SERVER_SENDING_STREAM_END: '🌊 [Server] Sending Stream End',
+  DEBUG_SERVER_SENDING_ERROR: '📤 [Server] Sending Error',
+  DEBUG_SERVER_SENDING_RESPONSE_VIA_DISPATCHER: '📤 [Server] Sending Response (via dispatcher)',
+  DEBUG_SERVER_HANDLING_REQUEST: '📥 [Server] Handling Request',
+  DEBUG_SERVER_EXECUTING_MIDDLEWARE_CHAIN: '⚙️ [Server] Executing Middleware Chain',
+  DEBUG_SERVER_MIDDLEWARE_CHAIN_COMPLETED: '✅ [Server] Middleware Chain Completed'
 };
 
 /**

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

@@ -0,0 +1,105 @@
+import { PostMessageData } from '../types';
+import { MessageDispatcher, VersionValidator, MessageContext } from '../message';
+/**
+ * Stream message handler callback
+ */
+export type StreamMessageCallback = (data: PostMessageData, context: MessageContext) => void;
+/**
+ * ClientServer configuration options
+ */
+export interface ClientServerOptions {
+    /** Message isolation key */
+    secretKey?: string;
+    /** ACK timeout */
+    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
+ * Only handles responses, not requests
+ * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
+ */
+export declare class RequestIframeClientServer {
+    private readonly dispatcher;
+    private readonly ackTimeout;
+    private readonly versionValidator;
+    /** Pending responses awaiting client acknowledgment */
+    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 */
+    private readonly unregisterFns;
+    /** Whether opened */
+    private _isOpen;
+    constructor(options?: ClientServerOptions, instanceId?: string);
+    /**
+     * Open message handling (register message handlers)
+     */
+    open(): void;
+    /**
+     * Close message handling (unregister message handlers, but don't release channel)
+     */
+    close(): void;
+    /**
+     * Whether opened
+     */
+    get isOpen(): boolean;
+    /**
+     * Register message handlers
+     */
+    private registerHandlers;
+    /**
+     * Handle protocol version error
+     */
+    private handleVersionError;
+    /**
+     * Handle client response
+     */
+    private handleClientResponse;
+    /**
+     * Handle received acknowledgment
+     */
+    private handleReceived;
+    /**
+     * Handle pong
+     */
+    private handlePong;
+    /**
+     * Set stream message handler callback
+     */
+    setStreamCallback(callback: StreamMessageCallback): void;
+    /** Get secretKey */
+    get secretKey(): string | undefined;
+    /** Get the underlying MessageDispatcher */
+    get messageDispatcher(): MessageDispatcher;
+    /**
+     * Register pending acknowledgment response
+     */
+    _registerPendingAck(requestId: string, resolve: (received: boolean) => void, reject: (error: Error) => void): void;
+    /**
+     * Register pending request awaiting response
+     */
+    _registerPendingRequest(requestId: string, resolve: (data: PostMessageData) => void, reject: (error: Error) => void, origin?: string): void;
+    /**
+     * Cancel pending response
+     */
+    _unregisterPendingRequest(requestId: string): void;
+    /**
+     * Send ping message
+     */
+    sendPing(targetWindow: Window, targetOrigin: string, requestId: string): void;
+    /**
+     * Destroy (close and release channel reference)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=client-server.d.ts.map

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

@@ -0,0 +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;;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"}