request-iframe 0.0.1

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

@@ -0,0 +1,99 @@
+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;
+}
+/**
+ * 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;
+    /** Stream message callback */
+    private streamCallback?;
+    /** List of unregister handler functions */
+    private readonly unregisterFns;
+    /** Whether opened */
+    private _isOpen;
+    constructor(options?: ClientServerOptions);
+    /**
+     * 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=server-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../src/core/server-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAoB7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,8BAA8B;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAwB;IAE/C,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,qBAAqB;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,mBAAmB;IAYhD;;OAEG;IACI,IAAI,IAAI,IAAI;IAMnB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsExB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI/D,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED;;OAEG;IACI,mBAAmB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,EACpC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC7B,IAAI;IASP;;OAEG;IACI,uBAAuB,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,EACxC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;IAIP;;OAEG;IACI,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACI,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpF;;OAEG;IACI,OAAO,IAAI,IAAI;CAavB"}

package/library/core/server-client.js

@@ -0,0 +1,256 @@
+"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) {
+    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.SERVER_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);
+
+    // Auto-open by default
+    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 messages (stream_*)
+    this.unregisterFns.push(this.dispatcher.registerHandler(type => type.startsWith('stream_'), (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 and async don't delete pending
+      if (data.type === _constants.MessageType.ACK || data.type === _constants.MessageType.ASYNC) {
+        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/server.d.ts

@@ -0,0 +1,82 @@
+import { ServerHandler, RequestIframeServer, Middleware, PathMatcher } from '../types';
+import { MessageDispatcher, VersionValidator } from '../message';
+/**
+ * Server configuration options
+ */
+export interface ServerOptions {
+    /** Message isolation secret key */
+    secretKey?: string;
+    /** ACK timeout duration */
+    ackTimeout?: number;
+    /** Protocol version validator (optional, uses built-in validator by default) */
+    versionValidator?: VersionValidator;
+}
+/**
+ * RequestIframeServer implementation
+ * Uses shared MessageDispatcher (backed by MessageChannel) to listen for and send messages
+ */
+export declare class RequestIframeServerImpl implements RequestIframeServer {
+    private readonly dispatcher;
+    private readonly ackTimeout;
+    private readonly versionValidator;
+    private readonly handlers;
+    private readonly middlewares;
+    /** Responses waiting for client acknowledgment */
+    private readonly pendingAcks;
+    /** List of functions to unregister handlers */
+    private readonly unregisterFns;
+    /** Whether it is open */
+    private _isOpen;
+    constructor(options?: ServerOptions);
+    /**
+     * Open message processing (register message handlers)
+     */
+    open(): void;
+    /**
+     * Close message processing (unregister message handlers, but don't release channel)
+     */
+    close(): void;
+    /**
+     * Whether it is open
+     */
+    get isOpen(): boolean;
+    /**
+     * Register message handlers
+     */
+    private registerHandlers;
+    /**
+     * Handle protocol version error
+     */
+    private handleVersionError;
+    /**
+     * Handle ping message
+     */
+    private handlePing;
+    /**
+     * Handle received acknowledgment
+     */
+    private handleReceived;
+    /** Get secretKey */
+    get secretKey(): string | undefined;
+    /** Get the underlying MessageDispatcher */
+    get messageDispatcher(): MessageDispatcher;
+    /**
+     * Handle request
+     */
+    private handleRequest;
+    /**
+     * Register pending acknowledgment response
+     */
+    private registerPendingAck;
+    use(middleware: Middleware): void;
+    use(path: PathMatcher, middleware: Middleware): void;
+    on(path: string, handler: ServerHandler): void;
+    private runMiddlewares;
+    off(path: string): void;
+    map(handlers: Record<string, ServerHandler>): void;
+    /**
+     * Destroy (close and release channel reference)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA8BjF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEL,OAAO,CAAC,EAAE,aAAa;IAY1C;;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;IAkCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB,oBAAoB;IACpB,IAAW,SAAS,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,2CAA2C;IAC3C,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IA2HrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAanB,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IACjC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAepD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIrD,OAAO,CAAC,cAAc;IA4Cf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvB,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAMzD;;OAEG;IACI,OAAO,IAAI,IAAI;CAgBvB"}