request-iframe 0.1.0 → 0.2.0

package/library/constants/index.js

@@ -3,14 +3,40 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.MessageType = exports.MessageRole = exports.HttpStatusText = exports.HttpStatus = exports.HttpHeader = exports.ErrorCode = exports.DefaultTimeout = void 0;
+exports.AutoAckConstant = void 0;
+Object.defineProperty(exports, "DebugEvent", {
+  enumerable: true,
+  get: function get() {
+    return _debug.DebugEvent;
+  }
+});
+exports.HttpStatusText = exports.HttpStatus = exports.HttpHeader = exports.ErrorCode = exports.DefaultTimeout = void 0;
+Object.defineProperty(exports, "LogLevel", {
+  enumerable: true,
+  get: function get() {
+    return _log.LogLevel;
+  }
+});
+exports.MessageType = exports.MessageRole = void 0;
 Object.defineProperty(exports, "Messages", {
   enumerable: true,
   get: function get() {
     return _messages.Messages;
   }
 });
-exports.StreamType = exports.StreamState = exports.StreamMode = exports.StreamInternalMessageType = exports.ProtocolVersion = void 0;
+exports.StreamType = exports.StreamState = exports.StreamMode = exports.StreamInternalMessageType = exports.StreamEvent = exports.ProtocolVersion = exports.OriginConstant = void 0;
+Object.defineProperty(exports, "WarnOnceKey", {
+  enumerable: true,
+  get: function get() {
+    return _warnOnce.WarnOnceKey;
+  }
+});
+Object.defineProperty(exports, "buildWarnOnceKey", {
+  enumerable: true,
+  get: function get() {
+    return _warnOnce.buildWarnOnceKey;
+  }
+});
 Object.defineProperty(exports, "formatMessage", {
   enumerable: true,
   get: function get() {
@@ -37,14 +63,17 @@ Object.defineProperty(exports, "setMessages", {
   }
 });
 var _messages = require("./messages");
-/**
- * Protocol version constants
- * Used to identify the protocol version of messages, for compatibility handling in future version upgrades
- * 
- * Version compatibility strategy:
- * - Only check minimum supported version, reject deprecated old versions
- * - Don't check maximum version, as new versions usually maintain backward compatibility with old message formats
- * - This way new version servers can be compatible with old version clients, without forcing client upgrades
+var _warnOnce = require("./warn-once");
+var _log = require("./log");
+var _debug = require("./debug");
+/**
+ * Protocol version constants
+ * Used to identify the protocol version of messages, for compatibility handling in future version upgrades
+ * 
+ * Version compatibility strategy:
+ * - Only check minimum supported version, reject deprecated old versions
+ * - Don't check maximum version, as new versions usually maintain backward compatibility with old message formats
+ * - This way new version servers can be compatible with old version clients, without forcing client upgrades
  */
 var ProtocolVersion = exports.ProtocolVersion = {
   /** Current protocol version */
@@ -53,16 +82,34 @@ var ProtocolVersion = exports.ProtocolVersion = {
   MIN_SUPPORTED: 1
 };
 
-/**
- * Protocol version type
+/**
+ * Special origin values
  */
+var OriginConstant = exports.OriginConstant = {
+  /** Wildcard origin (postMessage targetOrigin = '*') */
+  ANY: '*'
+};
+
+/**
+ * Auto-ack (ACK-only) limits.
+ */
+var AutoAckConstant = exports.AutoAckConstant = {
+  /** Max length of ack.id to be echoed back in auto-ack */
+  MAX_ID_LENGTH: 1024,
+  /** Max length of ack.meta to be echoed back in auto-ack */
+  MAX_META_LENGTH: 5120
+};
 
-/**
- * Protocol validation result
+/**
+ * Protocol version type
  */
 
-/**
- * HTTP status code constants
+/**
+ * Protocol validation result
+ */
+
+/**
+ * HTTP status code constants
  */
 var HttpStatus = exports.HttpStatus = {
   OK: 200,
@@ -79,8 +126,8 @@ var HttpStatus = exports.HttpStatus = {
   SERVICE_UNAVAILABLE: 503
 };
 
-/**
- * HTTP status text constants
+/**
+ * HTTP status text constants
  */
 var HttpStatusText = exports.HttpStatusText = {
   [HttpStatus.OK]: 'OK',
@@ -97,15 +144,15 @@ var HttpStatusText = exports.HttpStatusText = {
   [HttpStatus.SERVICE_UNAVAILABLE]: 'Service Unavailable'
 };
 
-/**
- * Get status text
+/**
+ * Get status text
  */
 function getStatusText(code) {
   return HttpStatusText[code] || 'Unknown';
 }
 
-/**
- * Error code constants
+/**
+ * Error code constants
  */
 var ErrorCode = exports.ErrorCode = {
   /** ACK confirmation timeout */
@@ -135,11 +182,27 @@ var ErrorCode = exports.ErrorCode = {
   /** Too many concurrent requests (rate limiting) */
   TOO_MANY_REQUESTS: 'TOO_MANY_REQUESTS',
   /** Stream start not received in time */
-  STREAM_START_TIMEOUT: 'STREAM_START_TIMEOUT'
+  STREAM_START_TIMEOUT: 'STREAM_START_TIMEOUT',
+  /** Stream has already started */
+  STREAM_ALREADY_STARTED: 'STREAM_ALREADY_STARTED',
+  /** Stream has ended */
+  STREAM_ENDED: 'STREAM_ENDED',
+  /** Stream idle timeout */
+  STREAM_TIMEOUT: 'STREAM_TIMEOUT',
+  /** Stream expired */
+  STREAM_EXPIRED: 'STREAM_EXPIRED',
+  /** Stream read error */
+  STREAM_READ_ERROR: 'STREAM_READ_ERROR',
+  /** Stream write() is only available when mode is push */
+  STREAM_WRITE_ONLY_IN_PUSH_MODE: 'STREAM_WRITE_ONLY_IN_PUSH_MODE',
+  /** Stream pending queue overflow */
+  STREAM_PENDING_QUEUE_OVERFLOW: 'STREAM_PENDING_QUEUE_OVERFLOW',
+  /** Stream pending bytes overflow */
+  STREAM_PENDING_BYTES_OVERFLOW: 'STREAM_PENDING_BYTES_OVERFLOW'
 };
 
-/**
- * Message type constants
+/**
+ * Message type constants
  */
 var MessageType = exports.MessageType = {
   /** Request message */
@@ -152,8 +215,6 @@ var MessageType = exports.MessageType = {
   RESPONSE: 'response',
   /** Error message */
   ERROR: 'error',
-  /** Client confirms response received */
-  RECEIVED: 'received',
   /** Ping message (for connection detection) */
   PING: 'ping',
   /** Pong message (for connection detection) */
@@ -169,9 +230,7 @@ var MessageType = exports.MessageType = {
   /** Stream cancel */
   STREAM_CANCEL: 'stream_cancel',
   /** Stream pull (receiver requests next chunks) */
-  STREAM_PULL: 'stream_pull',
-  /** Stream ack (receiver acknowledges a chunk) */
-  STREAM_ACK: 'stream_ack'
+  STREAM_PULL: 'stream_pull'
 };
 var MessageRole = exports.MessageRole = {
   /** Server role */
@@ -179,15 +238,15 @@ var MessageRole = exports.MessageRole = {
   /** Client role */
   CLIENT: 'client'
 };
-/**
- * Default timeout configuration (milliseconds)
+/**
+ * Default timeout configuration (milliseconds)
  */
 var DefaultTimeout = exports.DefaultTimeout = {
-  /** 
-   * 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 confirmation timeout: 1000ms (1s)
+   * Used for requireAck confirmation (ACK-only).
+   * Increased from 500ms to accommodate slower environments or busy browsers where postMessage
+   * serialization/deserialization may take longer.
    */
   ACK: 1000,
   /** Request timeout: 5s */
@@ -196,8 +255,8 @@ var DefaultTimeout = exports.DefaultTimeout = {
   ASYNC: 120000
 };
 
-/**
- * HTTP Header name constants
+/**
+ * HTTP Header name constants
  */
 var HttpHeader = exports.HttpHeader = {
   /** Set-Cookie (server sets cookie) */
@@ -212,20 +271,20 @@ var HttpHeader = exports.HttpHeader = {
   COOKIE: 'Cookie'
 };
 
-/**
- * HTTP Header name type
+/**
+ * HTTP Header name type
  */
 
-/**
- * Message type union type
+/**
+ * Message type union type
  */
 
-/**
- * Error code union type
+/**
+ * Error code union type
  */
 
-/**
- * Stream type constants
+/**
+ * Stream type constants
  */
 var StreamType = exports.StreamType = {
   /** Normal data stream */
@@ -234,18 +293,18 @@ var StreamType = exports.StreamType = {
   FILE: 'file'
 };
 
-/**
- * Stream mode constants
- * - PULL: receiver pulls next chunks (backpressure)
- * - PUSH: producer pushes via write()
+/**
+ * Stream mode constants
+ * - PULL: receiver pulls next chunks (backpressure)
+ * - PUSH: producer pushes via write()
  */
 var StreamMode = exports.StreamMode = {
   PULL: 'pull',
   PUSH: 'push'
 };
-/**
- * Stream internal message type constants (for stream internal message handling)
- * Note: These are MessageType.STREAM_* values with the stream_ prefix removed
+/**
+ * Stream internal message type constants (for stream internal message handling)
+ * Note: These are MessageType.STREAM_* values with the stream_ prefix removed
  */
 var StreamInternalMessageType = exports.StreamInternalMessageType = {
   /** Data message */
@@ -257,21 +316,19 @@ var StreamInternalMessageType = exports.StreamInternalMessageType = {
   /** Cancel message */
   CANCEL: 'cancel',
   /** Pull message */
-  PULL: 'pull',
-  /** Ack message */
-  ACK: 'ack'
+  PULL: 'pull'
 };
 
-/**
- * Stream internal message type value type
+/**
+ * Stream internal message type value type
  */
 
-/**
- * Stream type value type
+/**
+ * Stream type value type
  */
 
-/**
- * Stream state constants
+/**
+ * Stream state constants
  */
 var StreamState = exports.StreamState = {
   /** Pending */
@@ -286,10 +343,29 @@ var StreamState = exports.StreamState = {
   CANCELLED: 'cancelled'
 };
 
-/**
- * Stream state value type
+/**
+ * Stream state value type
+ */
+
+/**
+ * Stream event name constants (for stream.on / observability)
  */
+var StreamEvent = exports.StreamEvent = {
+  START: 'start',
+  DATA: 'data',
+  READ: 'read',
+  WRITE: 'write',
+  SEND: 'send',
+  PULL: 'pull',
+  ACK: 'ack',
+  END: 'end',
+  CANCEL: 'cancel',
+  ERROR: 'error',
+  TIMEOUT: 'timeout',
+  EXPIRED: 'expired',
+  STATE: 'state'
+};
 
-/**
- * Message constants (for multi-language support)
+/**
+ * Message constants (for multi-language support)
  */

package/library/constants/log.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Log level constants for request-iframe.
+ */
+export declare const LogLevel: {
+    readonly TRACE: "trace";
+    readonly INFO: "info";
+    readonly WARN: "warn";
+    readonly ERROR: "error";
+    readonly SILENT: "silent";
+};
+export type LogLevelValue = typeof LogLevel[keyof typeof LogLevel];
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/constants/log.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}

package/library/constants/log.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LogLevel = void 0;
+/**
+ * Log level constants for request-iframe.
+ */
+
+var LogLevel = exports.LogLevel = {
+  TRACE: 'trace',
+  INFO: 'info',
+  WARN: 'warn',
+  ERROR: 'error',
+  SILENT: 'silent'
+};

package/library/constants/messages.d.ts

@@ -32,11 +32,14 @@ declare const defaultMessages: {
     readonly MIDDLEWARE_ERROR: "Middleware error";
     readonly ERROR: "Error";
     readonly TOO_MANY_REQUESTS: "Too many concurrent requests (limit: {0})";
+    readonly HUB_REGISTER_HANDLERS_NOT_SET: "RequestIframeEndpointHub: registerHandlers is not set";
     /** Client errors */
     readonly IFRAME_NOT_READY: "iframe.contentWindow is not available";
     readonly TARGET_WINDOW_CLOSED: "Target window is closed or no longer available";
     /** ClientServer warnings */
     readonly CLIENT_SERVER_IGNORED_MESSAGE_WHEN_CLOSED: "Ignored message because client server is closed/destroyed (type: {0}, requestId: {1})";
+    /** Server warnings */
+    readonly SERVER_IGNORED_MESSAGE_WHEN_CLOSED: "Ignored message because 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";
@@ -48,6 +51,8 @@ declare const defaultMessages: {
     readonly STREAM_ENDED: "Stream has ended";
     readonly STREAM_READ_ERROR: "Failed to read stream data";
     readonly STREAM_WRITE_ONLY_IN_PUSH_MODE: "Stream write() is only available when mode is \"push\"";
+    readonly STREAM_PENDING_QUEUE_OVERFLOW: "Stream pending queue overflow (limit: {0})";
+    readonly STREAM_PENDING_BYTES_OVERFLOW: "Stream pending bytes overflow (limit: {0})";
     /** Debug messages - Client */
     readonly DEBUG_CLIENT_REQUEST_START: "📤 [Client] Request Start";
     readonly DEBUG_CLIENT_REQUEST_SUCCESS: "✅ [Client] Request Success";
@@ -64,7 +69,7 @@ declare const defaultMessages: {
     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";
+    readonly DEBUG_CLIENT_SENDING_RECEIVED_ACK: "📤 [Client] Sending ACK";
     /** Debug messages - Server */
     readonly DEBUG_SERVER_RECEIVED_REQUEST: "📥 [Server] Received Request";
     readonly DEBUG_SERVER_SETTING_STATUS_CODE: "📝 [Server] Setting Status Code";

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;;;;;;;IAQ9B,oBAAoB;;;IAIpB,4BAA4B;;IAI5B,8BAA8B;;;;;;;;;;;IAY9B,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;;;;;;;;IAS9B,oBAAoB;;;IAIpB,4BAA4B;;IAI5B,sBAAsB;;IAItB,8BAA8B;;;;;;;;;;;;;IAc9B,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

@@ -52,11 +52,14 @@ var defaultMessages = {
   MIDDLEWARE_ERROR: 'Middleware error',
   ERROR: 'Error',
   TOO_MANY_REQUESTS: 'Too many concurrent requests (limit: {0})',
+  HUB_REGISTER_HANDLERS_NOT_SET: 'RequestIframeEndpointHub: registerHandlers is not set',
   /** Client errors */
   IFRAME_NOT_READY: 'iframe.contentWindow is not available',
   TARGET_WINDOW_CLOSED: 'Target window is closed or no longer available',
   /** ClientServer warnings */
   CLIENT_SERVER_IGNORED_MESSAGE_WHEN_CLOSED: 'Ignored message because client server is closed/destroyed (type: {0}, requestId: {1})',
+  /** Server warnings */
+  SERVER_IGNORED_MESSAGE_WHEN_CLOSED: 'Ignored message because 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',
@@ -68,6 +71,8 @@ var defaultMessages = {
   STREAM_ENDED: 'Stream has ended',
   STREAM_READ_ERROR: 'Failed to read stream data',
   STREAM_WRITE_ONLY_IN_PUSH_MODE: 'Stream write() is only available when mode is "push"',
+  STREAM_PENDING_QUEUE_OVERFLOW: 'Stream pending queue overflow (limit: {0})',
+  STREAM_PENDING_BYTES_OVERFLOW: 'Stream pending bytes overflow (limit: {0})',
   /** Debug messages - Client */
   DEBUG_CLIENT_REQUEST_START: '📤 [Client] Request Start',
   DEBUG_CLIENT_REQUEST_SUCCESS: '✅ [Client] Request Success',
@@ -84,7 +89,7 @@ var defaultMessages = {
   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_CLIENT_SENDING_RECEIVED_ACK: '📤 [Client] Sending ACK',
   /** Debug messages - Server */
   DEBUG_SERVER_RECEIVED_REQUEST: '📥 [Server] Received Request',
   DEBUG_SERVER_SETTING_STATUS_CODE: '📝 [Server] Setting Status Code',

package/library/constants/warn-once.d.ts

@@ -0,0 +1,12 @@
+/**
+ * warnOnce keys (for deduplication).
+ *
+ * Keep these centralized to avoid scattered magic strings.
+ */
+export declare const WarnOnceKey: {
+    readonly INBOX_MISSING_PENDING_WHEN_CLOSED: "inbox:missingPendingWhenClosed";
+    readonly SERVER_MISSING_PENDING_WHEN_CLOSED: "server:missingPendingWhenClosed";
+};
+export type WarnOnceKeyValue = typeof WarnOnceKey[keyof typeof WarnOnceKey];
+export declare function buildWarnOnceKey(prefix: WarnOnceKeyValue, ...parts: Array<string | number>): string;
+//# sourceMappingURL=warn-once.d.ts.map

package/library/constants/warn-once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-once.d.ts","sourceRoot":"","sources":["../../src/constants/warn-once.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAGnG"}

package/library/constants/warn-once.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WarnOnceKey = void 0;
+exports.buildWarnOnceKey = buildWarnOnceKey;
+require("core-js/modules/es.array.map.js");
+/**
+ * warnOnce keys (for deduplication).
+ *
+ * Keep these centralized to avoid scattered magic strings.
+ */
+
+var WarnOnceKey = exports.WarnOnceKey = {
+  INBOX_MISSING_PENDING_WHEN_CLOSED: 'inbox:missingPendingWhenClosed',
+  SERVER_MISSING_PENDING_WHEN_CLOSED: 'server:missingPendingWhenClosed'
+};
+function buildWarnOnceKey(prefix, ...parts) {
+  if (!parts.length) return prefix;
+  return `${prefix}:${parts.map(String).join(':')}`;
+}