request-iframe 0.0.1 → 0.0.3

package/library/core/client-server.js

@@ -0,0 +1,266 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RequestIframeClientServer = void 0;
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.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");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _message = require("../message");
+var _cache = require("../utils/cache");
+var _utils = require("../utils");
+var _constants = require("../constants");
+/**
+ * Stream message handler callback
+ */
+
+/**
+ * Pending acknowledgment response
+ */
+
+/**
+ * Pending request awaiting response
+ */
+
+/**
+ * ClientServer configuration options
+ */
+
+/**
+ * RequestIframeClientServer - Client-side message server
+ * Only handles responses, not requests
+ * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
+ */
+class RequestIframeClientServer {
+  constructor(options, instanceId) {
+    var _options$ackTimeout, _options$versionValid;
+    /** Pending responses awaiting client acknowledgment */
+    (0, _defineProperty2.default)(this, "pendingAcks", new Map());
+    /** Pending requests awaiting response */
+    (0, _defineProperty2.default)(this, "pendingRequests", new Map());
+    /** List of unregister handler functions */
+    (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.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, _constants.MessageRole.CLIENT, instanceId);
+
+    // Auto-open by default (unless explicitly set to false)
+    if ((options === null || options === void 0 ? void 0 : options.autoOpen) !== false) {
+      this.open();
+    }
+  }
+
+  /**
+   * Open message handling (register message handlers)
+   */
+  open() {
+    if (this._isOpen) return;
+    this._isOpen = true;
+    this.registerHandlers();
+  }
+
+  /**
+   * Close message handling (unregister message handlers, but don't release channel)
+   */
+  close() {
+    if (!this._isOpen) return;
+    this._isOpen = false;
+
+    // Unregister all handlers
+    this.unregisterFns.forEach(fn => fn());
+    this.unregisterFns.length = 0;
+  }
+
+  /**
+   * Whether opened
+   */
+  get isOpen() {
+    return this._isOpen;
+  }
+
+  /**
+   * Register message handlers
+   */
+  registerHandlers() {
+    var handlerOptions = {
+      versionValidator: this.versionValidator,
+      onVersionError: this.handleVersionError.bind(this)
+    };
+
+    // Handle ACK messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ACK, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+
+    // Handle ASYNC messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ASYNC, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+
+    // Handle RESPONSE messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RESPONSE, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+
+    // Handle ERROR messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.ERROR, (data, context) => this.handleClientResponse(data, context), handlerOptions));
+
+    // Handle RECEIVED messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.RECEIVED, data => this.handleReceived(data), handlerOptions));
+
+    // Handle PONG messages
+    this.unregisterFns.push(this.dispatcher.registerHandler(_constants.MessageType.PONG, (data, context) => this.handlePong(data, context), 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));
+
+    // 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));
+  }
+
+  /**
+   * Handle protocol version error
+   */
+  handleVersionError(data, context, version) {
+    // For response messages, we need to notify the waiting request
+    var pending = this.pendingRequests.get(data.requestId);
+    if (pending) {
+      this.pendingRequests.delete(data.requestId);
+      pending.reject(new Error((0, _constants.formatMessage)(_constants.Messages.PROTOCOL_VERSION_TOO_LOW, version, _constants.ProtocolVersion.MIN_SUPPORTED)));
+    }
+  }
+
+  /**
+   * Handle client response
+   */
+  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;
+      }
+      // response and error delete pending
+      this.pendingRequests.delete(data.requestId);
+      pending.resolve(data);
+    }
+  }
+
+  /**
+   * Handle received acknowledgment
+   */
+  handleReceived(data) {
+    var pending = this.pendingAcks.get(data.requestId);
+    if (pending) {
+      clearTimeout(pending.timeoutId);
+      this.pendingAcks.delete(data.requestId);
+      pending.resolve(true);
+    }
+  }
+
+  /**
+   * Handle pong
+   */
+  handlePong(data, context) {
+    var pending = this.pendingRequests.get(data.requestId);
+    if (pending) {
+      if (pending.origin && pending.origin !== '*' && context.origin !== pending.origin) {
+        return;
+      }
+      this.pendingRequests.delete(data.requestId);
+      pending.resolve(data);
+    }
+  }
+
+  /**
+   * Set stream message handler callback
+   */
+  setStreamCallback(callback) {
+    this.streamCallback = callback;
+  }
+
+  /** Get secretKey */
+  get secretKey() {
+    return this.dispatcher.secretKey;
+  }
+
+  /** Get the underlying MessageDispatcher */
+  get messageDispatcher() {
+    return this.dispatcher;
+  }
+
+  /**
+   * Register pending acknowledgment response
+   */
+  _registerPendingAck(requestId, resolve, reject) {
+    var timeoutId = setTimeout(() => {
+      this.pendingAcks.delete(requestId);
+      resolve(false);
+    }, this.ackTimeout);
+    this.pendingAcks.set(requestId, {
+      resolve,
+      reject,
+      timeoutId
+    });
+  }
+
+  /**
+   * Register pending request awaiting response
+   */
+  _registerPendingRequest(requestId, resolve, reject, origin) {
+    this.pendingRequests.set(requestId, {
+      resolve,
+      reject,
+      origin
+    });
+  }
+
+  /**
+   * Cancel pending response
+   */
+  _unregisterPendingRequest(requestId) {
+    this.pendingRequests.delete(requestId);
+  }
+
+  /**
+   * Send ping message
+   */
+  sendPing(targetWindow, targetOrigin, requestId) {
+    this.dispatcher.sendMessage(targetWindow, targetOrigin, _constants.MessageType.PING, requestId);
+  }
+
+  /**
+   * Destroy (close and release channel reference)
+   */
+  destroy() {
+    // Close first
+    this.close();
+
+    // Clear pending
+    this.pendingRequests.clear();
+    this.pendingAcks.forEach(pending => clearTimeout(pending.timeoutId));
+    this.pendingAcks.clear();
+
+    // Destroy dispatcher and release channel reference
+    this.dispatcher.destroy();
+    (0, _cache.releaseMessageChannel)(this.dispatcher.getChannel());
+  }
+}
+exports.RequestIframeClientServer = RequestIframeClientServer;

package/library/core/client.d.js

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

package/library/core/client.d.ts

@@ -1,17 +1,20 @@
-import { RequestOptions, Response, RequestIframeClient, RequestDefaults } from '../types';
+import { RequestOptions, Response, RequestIframeClient, RequestDefaults, HeadersConfig } from '../types';
 import { RequestInterceptorManager, ResponseInterceptorManager } from '../interceptors';
-import { RequestIframeClientServer } from './server-client';
+import { RequestIframeClientServer } from './client-server';
 import { StreamMessageHandler, StreamMessageData } from '../stream';
 /**
  * Client configuration options
  */
 export interface ClientOptions extends RequestDefaults {
     secretKey?: string;
+    headers?: HeadersConfig;
 }
 /**
  * RequestIframeClient implementation (only responsible for initiating requests, reuses server's listener)
  */
 export declare class RequestIframeClientImpl implements RequestIframeClient, StreamMessageHandler {
+    /** Unique instance ID */
+    readonly id: string;
     interceptors: {
         request: RequestInterceptorManager;
         response: ResponseInterceptorManager;
@@ -24,6 +27,8 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
     private readonly defaultAckTimeout;
     private readonly defaultTimeout;
     private readonly defaultAsyncTimeout;
+    /** Initial headers configuration */
+    private readonly initialHeaders?;
     /**
      * Internal cookies storage
      * - Automatically includes cookies matching the path when sending requests
@@ -36,7 +41,12 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      * value: stream message handler function
      */
     private readonly streamHandlers;
-    constructor(targetWindow: Window, targetOrigin: string, server: RequestIframeClientServer, options?: ClientOptions);
+    /**
+     * Target server ID (remembered from responses)
+     * When a response is received, we remember the server's creatorId as the targetId for future requests
+     */
+    private _targetServerId?;
+    constructor(targetWindow: Window, targetOrigin: string, server: RequestIframeClientServer, options?: ClientOptions, instanceId?: string);
     /**
      * Register stream message handler (StreamMessageHandler interface implementation)
      */
@@ -45,14 +55,20 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      * Unregister stream message handler (StreamMessageHandler interface implementation)
      */
     unregisterStreamHandler(streamId: string): void;
-    /**
-     * Send message (StreamMessageHandler interface implementation)
-     */
     postMessage(message: any): void;
     /**
      * Dispatch stream message to corresponding handler
      */
     private dispatchStreamMessage;
+    /**
+     * Resolve header value (handle function type headers)
+     */
+    private resolveHeaderValue;
+    /**
+     * Merge and resolve headers (initial headers + request headers)
+     * Request headers take precedence over initial headers
+     */
+    private mergeHeaders;
     /**
      * Check if server is reachable
      */
@@ -63,6 +79,22 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      * Get internal server instance (for debugging)
      */
     getServer(): RequestIframeClientServer;
+    /**
+     * Whether message handling is enabled
+     */
+    get isOpen(): boolean;
+    /**
+     * Enable message handling (register message handlers)
+     */
+    open(): void;
+    /**
+     * Disable message handling (unregister message handlers, but don't release resources)
+     */
+    close(): void;
+    /**
+     * Destroy client (close and release all resources)
+     */
+    destroy(): void;
     /**
      * Get all cookies matching specified path
      * @param path Request path, returns all cookies if not provided

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,EAChB,MAAM,UAAU,CAAC;AAKlB,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;CACpB;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB,EAAE,oBAAoB;IAChF,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;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAkC;IAEtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;gBAGrF,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,aAAa;IAkBzB;;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;IAItD;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAItC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;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;IAmQvB,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACI,SAAS,IAAI,yBAAyB;IAI7C;;;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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"}